fizzy-cli

---
name: fizzy-cli
description: Use the fizzy-cli tool to authenticate and manage Fizzy kanban boards, cards, comments, tags, columns, users, and notifications from the command line. Apply this skill when you need to list, create, update, or delete Fizzy resources or when scripting Fizzy workflows.
metadata:
  author: tobiasbischoff
  version: "1.0"
---

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