fizzy-cli

# 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.