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