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 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 <board-id> --name "New name"
• Delete: fizzy-cli board delete <board-id>

Cards

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

Comments

• List comments:
  • fizzy-cli comment list <card-number>
• Create comment:
  • fizzy-cli comment create <card-number> --body "Looks good"

Tags, Columns, Users, Notifications

• Tags: fizzy-cli tag list
• Columns: fizzy-cli column list --board-id <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 <slug> or fizzy-cli config set --account <slug>.
• Use fizzy-cli --help or fizzy-cli help <command> for full usage.