Skip to content

Commit 97743bf

Browse files
waynemsmithclaude
andcommitted
Document fizzy token command and commands discovery in skill
The skill covered every workflow command but omitted the `fizzy token` group (personal access token create/list/delete) entirely, and never pointed agents at `fizzy commands` for live capability discovery. Add a Tokens section, a quick-ref row, and a discovery note. Docs-only; command tree unchanged. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent 93e76f1 commit 97743bf

1 file changed

Lines changed: 26 additions & 0 deletions

File tree

skills/fizzy/SKILL.md

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -97,6 +97,10 @@ Want to change something?
9797

9898
## Quick Reference
9999

100+
> Discovery: run `fizzy commands` (alias `cmds`) for the live command catalog, or
101+
> `fizzy commands --json` for a structured tree of every command and flag. Use it
102+
> to confirm a command exists in the installed binary before relying on it.
103+
100104
| Resource | List | Show | Create | Update | Delete | Other |
101105
|----------|------|------|--------|--------|--------|-------|
102106
| account | - | `account show` | - | `account settings-update` | - | `account entropy`, `account export-create`, `account export-show EXPORT_ID`, `account join-code-show`, `account join-code-reset`, `account join-code-update` |
@@ -114,6 +118,7 @@ Want to change something?
114118
| notification | `notification list` | - | - | - | - | `notification tray`, `notification read-all`, `notification settings-show`, `notification settings-update` |
115119
| pin | `pin list` | - | - | - | - | `card pin NUMBER`, `card unpin NUMBER` |
116120
| webhook | `webhook list --board ID`, `webhook deliveries --board ID WEBHOOK_ID` | `webhook show ID --board ID` | `webhook create` | `webhook update ID` | `webhook delete ID` | `webhook reactivate ID` |
121+
| token | `token list` | - | `token create --description NAME --permission PERM` | - | `token delete ID` | personal access tokens (see Tokens) |
117122

118123
---
119124

@@ -802,6 +807,27 @@ fizzy account join-code-reset # Reset join code
802807
fizzy account join-code-update --usage-limit N # Update join code limit
803808
```
804809

810+
### Tokens (Personal Access Tokens)
811+
812+
Personal access tokens are the credentials the CLI authenticates with. Most users
813+
never touch these — the token saved by `fizzy setup` / `fizzy auth login` is used
814+
automatically by every command. Use `fizzy token` to provision a *separate*,
815+
scoped token for automation (CI, webhooks, another machine, or an agent), or to
816+
rotate/revoke a compromised one without disturbing your other tokens.
817+
818+
```bash
819+
fizzy token list # List your personal access tokens (alias: ls)
820+
fizzy token create --description "CI deploy" --permission write # Create a token (both flags required)
821+
fizzy token delete TOKEN_ID # Revoke a single token
822+
```
823+
824+
- `--description` and `--permission` are both **required** on create.
825+
- `--permission` accepts `write` (known-good); a read-only scope also exists. The
826+
token **value is shown once at creation and cannot be retrieved later** — capture
827+
it immediately.
828+
- Prefer a dedicated token per consumer so revoking one (leak, retired machine)
829+
doesn't log out everything else.
830+
805831
### File Uploads
806832

807833
```bash

0 commit comments

Comments
 (0)