@@ -97,10 +97,6 @@ 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-
104100| Resource | List | Show | Create | Update | Delete | Other |
105101| ----------| ------| ------| --------| --------| --------| -------|
106102| 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 ` |
@@ -118,7 +114,6 @@ Want to change something?
118114| notification | ` notification list ` | - | - | - | - | ` notification tray ` , ` notification read-all ` , ` notification settings-show ` , ` notification settings-update ` |
119115| pin | ` pin list ` | - | - | - | - | ` card pin NUMBER ` , ` card unpin NUMBER ` |
120116| 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) |
122117
123118---
124119
@@ -807,27 +802,6 @@ fizzy account join-code-reset # Reset join code
807802fizzy account join-code-update --usage-limit N # Update join code limit
808803` ` `
809804
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-
831805# ## File Uploads
832806
833807` ` ` bash
@@ -1180,7 +1154,4 @@ fizzy auth status # Shows configured profile and API URL
11801154# # Learn More
11811155
11821156- API documentation : https://github.com/basecamp/fizzy/blob/main/docs/API.md
1183- - CLI repository (this fork is the source of the `fizzy` command) : https://github.com/Concurrent-Systems/fizzy-cli
1184- - Local clone : ` ~/g/fizzy-cli-fork` (branch `master` = upstream + our docs only; no functional patches)
1185- - Build & install : ` cd ~/g/fizzy-cli-fork && make build && cp bin/fizzy ~/.local/bin/fizzy`
1186- - Update : ` git checkout master && git pull` , then rebuild/install. Upstream sync via the `upstream` remote (`basecamp/fizzy-cli`).
1157+ - CLI repository : https://github.com/basecamp/fizzy-cli
0 commit comments