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 user@example.com
- 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 --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.