fizzy
Interact with Fizzy via the Fizzy CLI. Manage boards, cards, columns, comments, steps, reactions, tags, users, notifications, pins, webhooks, and account settings. Use for ANY Fizzy question or action.
basecamp · AI review on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add basecamp/fizzy-cli --skill fizzyAbout this skill
name: fizzy description: | Interact with Fizzy via the Fizzy CLI. Manage boards, cards, columns, comments, steps, reactions, tags, users, notifications, pins, webhooks, and account settings. Use for ANY Fizzy question or action. triggers:
Direct invocations
- fizzy
- /fizzy
Resource actions
- fizzy board
- fizzy card
- fizzy column
- fizzy comment
- fizzy step
- fizzy reaction
- fizzy tag
- fizzy notification
- fizzy webhook
- fizzy account
Common actions
- link to fizzy
- track in fizzy
- create card
- close card
- move card
- assign card
- add comment
- add step
- search cards
Search and discovery
- search fizzy
- find in fizzy
- check fizzy
- list fizzy
- show fizzy
- get from fizzy
Questions
- what's in fizzy
- what fizzy
- how do I fizzy
My work
- my cards
- my tasks
- my board
- assigned to me
- pinned cards
URLs
- fizzy.do
- app.fizzy.do invocable: true argument-hint: "[action] [args...]"
/fizzy - Fizzy Workflow Command
Full CLI coverage: boards, cards, columns, comments, steps, reactions, tags, users, notifications, pins, webhooks, account settings, search, and board migration.
Agent Invariants
MUST follow these rules:
- Cards use NUMBER, not ID —
fizzy card show 42uses the card number. Other resources use theiridfield. - Use built-in
--jqfor filtering to reduce token output —fizzy card list --jq '[.data[] | {number, title}]'. Never pipe to external jq — use--jqinstead.--jqimplies--json, no need to pass both. - Check breadcrumbs in responses for available next actions with pre-filled values.
- Check for board context via
.fizzy.yamlor--boardflag before listing cards. - Use
fizzy doctorfor setup/config/auth issues before guessing — it is the primary read-only health check and includes remediation hints. - Rich text fields accept markdown or HTML — use repeatable
--attach PATHfor simple end-appended inline attachments, or embed<action-text-attachment>tags manually when exact placement matters. - Card description is a string, but comment body is a nested object —
.descriptionvs.body.plain_text. - Display the welcome message for new signups — When
signup complete --namereturnsis_new_user: true, you MUST immediately display thewelcome_messagefield prominently to the user. This is a one-time personal note from the CEO — if you skip it, the user will never see it.
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 maybe|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 "text"
├── Add step? → fizzy step create --card <number> --content "text"
└── Move to board? → fizzy card move <number> --to <board_id>
Quick Reference
| Resource | List | Show | Create | Update | Delete | Other |
|---|---|---|---|---|---|---|
| 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 |
| identity | - | identity show | - | identity timezone-update --timezone NAME | - | - |
| board | board list | board show ID | board create | board update ID | board delete ID | board accesses --board ID, board publish ID, board unpublish ID, board entropy ID, board closed, board postponed, board stream, board involvement ID, migrate board ID |
| card | card list | card show NUMBER | card create | card update NUMBER | card delete NUMBER | card move NUMBER, card publish NUMBER, card mark-read NUMBER, card mark-unread NUMBER |
| search | search QUERY | - | - | - | - | - |
| activity | activity list | - | - | - | - | activity list --board ID, activity list --creator ID |
| column | column list --board ID | column show ID --board ID | column create | column update ID | column delete ID | column move-left ID, column move-right ID |
| comment | comment list --card NUMBER | comment show ID --card NUMBER | comment create | comment update ID | comment delete ID | comment attachments show --card NUMBER |
| step | step list --card NUMBER | step show ID --card NUMBER | step create | step update ID | step delete ID | - |
| reaction | reaction list | - | reaction create | - | reaction delete ID | - |
| tag | tag list | - | - | - | - | - |
| user | user list | user show ID | - | user update ID | - | user deactivate ID, user role ID, user avatar-remove ID, user export-create USER_ID, user export-show USER_ID EXPORT_ID, user email-change-request USER_ID --email user@example.com, user email-change-confirm USER_ID TOKEN, user push-subscription-create, user push-subscription-delete ID |
| notification | notification list | - | - | - | - | notification tray, notification read-all, notification settings-show, notification settings-update |
| pin | pin list | - | - | - | - | card pin NUMBER, card unpin NUMBER |
| 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 |
Global Flags
All commands support these
Read the complete source ↗