fizzy

Fizzy — Project Management via Fizzy CLI

Full CLI coverage: boards, cards, columns, comments, steps, reactions, tags, users, notifications, pins, webhooks, account settings, search, and board migration.

Requires the Fizzy CLI and jq. Check with fizzy auth status before the first command.

Agent Invariants

MUST follow these rules:

1. Cards use NUMBER, not ID — fizzy card show 42 uses the card number. Other resources use their id field.
2. Parse JSON with jq to reduce token output — fizzy card list | jq '[.data[] | {number, title}]'
3. Check breadcrumbs in responses for available next actions with pre-filled values
4. Check for board context via .fizzy.yaml or --board flag before listing cards
5. Rich text fields accept HTML — use <p> tags for paragraphs, <action-text-attachment> for inline images
6. Card description is a string, but comment body is a nested object — .description vs .body.plain_text
7. Ask the user before irreversible commands — delete, deactivate, and account join-code-reset cannot be undone. State what will be affected and wait for a yes. For migrate board, run with --dry-run first and show the preview before the real run.
8. Use the default output — the piped JSON envelope. Do not add --agent, --quiet, or --markdown: they drop the {ok, data, breadcrumbs} envelope that invariants 2-3 and every jq example rely on.

Decision Trees

Finding Content

Need to find something?
├── Know the board? → fizzy card list --board <id>
├── Full-text search? → fizzy search "query"
├── Filter by status? → fizzy card list --indexed-by closed|not_now|golden|stalled
├── Filter by person? → fizzy card list --assignee <id>
├── Filter by time? → fizzy card list --created today|thisweek|thismonth
└── Cross-board? → fizzy search "query" (searches all boards)

Modifying Content

Want to change something?
├── Move to column? → fizzy card column <number> --column <id>
├── Change status? → fizzy card close|reopen|postpone <number>
├── Assign? → fizzy card assign <number> --user <id>
├── Comment? → fizzy comment create --card <number> --body "<p>text</p>"
├── Add step? → fizzy step create --card <number> --content "text"
└── Move to board? → fizzy card move <number> --to <board_id>