Fizzy CLI Skill

Use this skill to operate the Fizzy kanban board via the fizzy-cli command. It covers authentication, configuration, and common CRUD workflows.

Quick Start

1) Authenticate

• Token:
• fizzy-cli auth login --token $FIZZY_TOKEN
• Magic link:
• fizzy-cli auth login --email [email protected]
• If non-interactive, pass --code ABC123.

2) Set defaults

• Account only: fizzy-cli account set 897362094
• Persist base URL + account: fizzy-cli config set --base-url https://app.fizzy.do --account 897362094

3) Verify access

• fizzy-cli auth status
• fizzy-cli account list

Common Tasks

Boards

• List: fizzy-cli board list
• Create: fizzy-cli board create --name "Roadmap"
• Update: fizzy-cli board update --name "New name"
• Delete: fizzy-cli board delete

Cards

• List cards on a board:
• fizzy-cli card list --board-id
• Create card:
• fizzy-cli card create --board-id --title "Add dark mode" --description "Switch theme"
• Upload image:
• fizzy-cli card create --board-id --title "Add hero" --image ./hero.png
• Update card:
• fizzy-cli card update --title "Updated" --tag-id
• Move to Not Now:
• fizzy-cli card not-now
• Close / reopen:
• fizzy-cli card close
• fizzy-cli card reopen
• Triage / untriage:
• fizzy-cli card triage --column-id
• fizzy-cli card untriage

Comments

• List comments:
• fizzy-cli comment list
• Create comment:
• fizzy-cli comment create --body "Looks good"

Tags, Columns, Users, Notifications

• Tags: fizzy-cli tag list
• Columns: fizzy-cli column list --board-id
• Users: fizzy-cli user list
• Notifications: fizzy-cli notification list --unread

Output Modes

• Default: human-readable tables.
• Machine output:
• --json for raw API JSON.
• --plain for stable line-based output.

Config & Auth Notes

• Config file: ~/.config/fizzy/config.json.
• Env vars: FIZZY_BASE_URL, FIZZY_TOKEN, FIZZY_ACCOUNT, FIZZY_CONFIG.
• Precedence: flags > env > config file > defaults.

Troubleshooting

• If requests fail with auth errors, run fizzy-cli auth status and re-login.
• If account is missing, set it via fizzy-cli account set or fizzy-cli config set --account .
• Use fizzy-cli --help or fizzy-cli help for full usage.