platform/seed/skills/fizzy-cli/SKILL.md

name, description

name	description
fizzy-cli	Manage Fizzy boards, cards, columns, and comments from the command line. Use when the user wants to create, list, update, or organize cards and boards on Fizzy.

Fizzy CLI

CLI reference for fizzy-cli — a command-line interface for the Fizzy API to manage boards, cards, columns, comments, and more.

Source: https://github.com/robzolkos/fizzy-cli

Configuration

Configuration sources in order of precedence (highest first):

1. Command-line flags (--token, --account, --api-url)
2. Environment variables (FIZZY_TOKEN, FIZZY_ACCOUNT, FIZZY_API_URL, FIZZY_BOARD)
3. Local project config (.fizzy.yaml in current or parent directories)
4. Global config (~/.config/fizzy/config.yaml or ~/.fizzy/config.yaml)

Run fizzy setup for interactive configuration.

Global Options

Flag	Env Variable	Description
--token	FIZZY_TOKEN	API access token
--account	FIZZY_ACCOUNT	Account identifier
--api-url	FIZZY_API_URL	API base URL (default: https://app.fizzy.do)
--verbose	—	Display request/response details

---

Commands

Boards

Command	Description
fizzy board list	List all boards
fizzy board show BOARD_ID	Display board details
fizzy board create --name "Name"	Create a new board
fizzy board update BOARD_ID --name "Name"	Update a board
fizzy board delete BOARD_ID	Delete a board

Cards

List cards

fizzy card list [--board ID] [--column ID] [--tag ID] [--assignee ID]
fizzy card list [--sort newest|oldest|latest] [--search "text"]
fizzy card list [--created thisweek] [--closed thisweek] [--unassigned]

CRUD

Command	Description
fizzy card show CARD_ID	View card details
fizzy card create --board ID --title "Title"	Create a card
fizzy card update CARD_ID --title "Title"	Update a card
fizzy card delete CARD_ID	Delete a card

Card actions

Command	Description
fizzy card close CARD_ID	Close a card
fizzy card reopen CARD_ID	Reopen a card
fizzy card move CARD_ID --to BOARD_ID	Move card to another board
fizzy card postpone CARD_ID	Postpone a card
fizzy card column CARD_ID --column COLUMN_ID	Assign card to a column
fizzy card assign CARD_ID --user USER_ID	Assign card to a user
fizzy card tag CARD_ID --tag "tag"	Tag a card
fizzy card pin CARD_ID	Pin a card
fizzy card unpin CARD_ID	Unpin a card
fizzy card golden CARD_ID	Mark card as golden
fizzy card ungolden CARD_ID	Remove golden status
fizzy card watch CARD_ID	Watch a card
fizzy card unwatch CARD_ID	Unwatch a card

Card attachments

Command	Description
fizzy card attachments show CARD_ID	List attachments
fizzy card attachments download CARD_ID	Download all attachments
fizzy card attachments download CARD_ID ATT_ID	Download specific attachment

Columns

Command	Description
fizzy column list --board ID	List columns
fizzy column show COLUMN_ID --board ID	View column
fizzy column create --board ID --name "Name"	Create column
fizzy column update COLUMN_ID --board ID --name "Name"	Update column
fizzy column delete COLUMN_ID --board ID	Delete column

Comments

Command	Description
fizzy comment list --card CARD_ID	List comments
fizzy comment show COMMENT_ID --card CARD_ID	View comment
fizzy comment create --card CARD_ID --body "Text"	Add comment
fizzy comment update COMMENT_ID --card CARD_ID --body "Text"	Edit comment
fizzy comment delete COMMENT_ID --card CARD_ID	Delete comment

Comment attachments

Command	Description
fizzy comment attachments show --card CARD_ID	List attachments
fizzy comment attachments download --card CARD_ID	Download all
fizzy comment attachments download --card CARD_ID ATT_ID	Download specific

Steps (To-Do Items)

Command	Description
fizzy step show STEP_ID --card CARD_ID	View step
fizzy step create --card CARD_ID --content "Task"	Create step
fizzy step update STEP_ID --card CARD_ID --completed	Mark step complete
fizzy step delete STEP_ID --card CARD_ID	Delete step

Reactions

Command	Description
fizzy reaction list --card CARD_ID	List reactions
fizzy reaction create --card CARD_ID --content "👍"	Add reaction
fizzy reaction delete REACTION_ID --card CARD_ID	Remove reaction

Users & Tags

Command	Description
fizzy user list	List users
fizzy user show USER_ID	View user details
fizzy tag list	List available tags

Pins, Search & Notifications

Command	Description
fizzy pin list	List pinned cards
fizzy search "term"	Full-text card search
fizzy notification list	List notifications
fizzy notification read ID	Mark notification as read
fizzy notification unread ID	Mark notification as unread
fizzy notification read-all	Mark all notifications as read

File Uploads

fizzy upload file /path/to/file.png
# Returns: { "signed_id": "...", "attachable_sgid": "..." }

Use signed_id for card headers; attachable_sgid for inline images in rich text.

---

Source

• Repository: https://github.com/robzolkos/fizzy-cli