Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Development

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 fizzy

About 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:

  1. Cards use NUMBER, not ID — fizzy card show 42 uses the card number. Other resources use their id field.
  2. Use built-in --jq for filtering to reduce token output — fizzy card list --jq '[.data[] | {number, title}]'. Never pipe to external jq — use --jq instead. --jq implies --json, no need to pass both.
  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. Use fizzy doctor for setup/config/auth issues before guessing — it is the primary read-only health check and includes remediation hints.
  6. Rich text fields accept markdown or HTML — use repeatable --attach PATH for simple end-appended inline attachments, or embed <action-text-attachment> tags manually when exact placement matters.
  7. Card description is a string, but comment body is a nested object — .description vs .body.plain_text.
  8. Display the welcome message for new signups — When signup complete --name returns is_new_user: true, you MUST immediately display the welcome_message field 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

ResourceListShowCreateUpdateDeleteOther
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--
boardboard listboard show IDboard createboard update IDboard delete IDboard accesses --board ID, board publish ID, board unpublish ID, board entropy ID, board closed, board postponed, board stream, board involvement ID, migrate board ID
cardcard listcard show NUMBERcard createcard update NUMBERcard delete NUMBERcard move NUMBER, card publish NUMBER, card mark-read NUMBER, card mark-unread NUMBER
searchsearch QUERY-----
activityactivity list----activity list --board ID, activity list --creator ID
columncolumn list --board IDcolumn show ID --board IDcolumn createcolumn update IDcolumn delete IDcolumn move-left ID, column move-right ID
commentcomment list --card NUMBERcomment show ID --card NUMBERcomment createcomment update IDcomment delete IDcomment attachments show --card NUMBER
stepstep list --card NUMBERstep show ID --card NUMBERstep createstep update IDstep delete ID-
reactionreaction list-reaction create-reaction delete ID-
tagtag list-----
useruser listuser 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
notificationnotification list----notification tray, notification read-all, notification settings-show, notification settings-update
pinpin list----card pin NUMBER, card unpin NUMBER
webhookwebhook list --board ID, webhook deliveries --board ID WEBHOOK_IDwebhook show ID --board IDwebhook createwebhook update IDwebhook delete IDwebhook reactivate ID

Global Flags

All commands support these

Read the complete source ↗