Support profile aliases for shared Fizzy accounts

README.md

@@ -192,12 +192,37 @@ Breadcrumbs suggest next commands, making it easy for humans and agents to navig
 Configuration priority (highest to lowest):
 1. CLI flags (`--token`, `--profile`, `--api-url`, `--board`)
 2. Environment variables (`FIZZY_TOKEN`, `FIZZY_PROFILE`, `FIZZY_API_URL`, `FIZZY_BOARD`)
-3. Named profile settings (base URL, board from `config.json`)
+3. Named profile settings (account, base URL, board from `config.json`)
 4. Local project config (`.fizzy.yaml`)
 5. Global config (`~/.config/fizzy/config.yaml` or `~/.fizzy/config.yaml`)
 
 `FIZZY_ACCOUNT` is accepted as a deprecated alias for `FIZZY_PROFILE`.
 
+Profiles created by `fizzy setup` use the account slug as their name and continue to work without changes. A profile can also use a distinct name by storing its account in the profile's `extra` settings. This supports separate credentials for multiple users of the same account:
+
+```bash
+fizzy auth login "$WALTER_TOKEN" --profile walter --account 1
+fizzy auth login "$AGENT_TOKEN" --profile walter-agent --account 1
+```
+
+The commands store credentials under each profile name while routing both profiles to account `1`:
+
+```json
+{
+  "profiles": {
+    "walter": {
+      "base_url": "https://app.fizzy.do",
+      "extra": { "account": "1" }
+    },
+    "walter-agent": {
+      "base_url": "https://app.fizzy.do",
+      "extra": { "account": "1" }
+    }
+  },
+  "default_profile": "walter"
+}
+```
+
 `FIZZY_NO_UPDATE_NOTIFIER=1` runs commands without update notifications.
 
 Inspect the effective config and precedence:

SURFACE.txt

@@ -513,6 +513,7 @@ FLAG fizzy auth list --quiet type=bool
 FLAG fizzy auth list --styled type=bool
 FLAG fizzy auth list --token type=string
 FLAG fizzy auth list --verbose type=bool
+FLAG fizzy auth login --account type=string
 FLAG fizzy auth login --agent type=bool
 FLAG fizzy auth login --api-url type=string
 FLAG fizzy auth login --count type=bool

go.mod

@@ -15,6 +15,7 @@ require (
 	github.com/spf13/cobra v1.10.2
 	github.com/spf13/pflag v1.0.10
 	github.com/yuin/goldmark v1.8.4
+	github.com/zalando/go-keyring v0.2.8
 	gopkg.in/yaml.v3 v3.0.1
 )
 
@@ -44,7 +45,6 @@ require (
 	github.com/muesli/cancelreader v0.2.2 // indirect
 	github.com/rivo/uniseg v0.4.7 // indirect
 	github.com/xo/terminfo v0.0.0-20220910002029-abceb7e1c41e // indirect
-	github.com/zalando/go-keyring v0.2.8 // indirect
 	golang.org/x/sync v0.19.0 // indirect
 	golang.org/x/sys v0.41.0 // indirect
 	golang.org/x/text v0.34.0 // indirect