fizzy-cli

Notes & PKM
v1.0.0
Benign

Use the fizzy-cli tool to authenticate and manage Fizzy kanban.

11.7K downloads1.7K installsby @tobiasbischoff

Setup & Installation

Install command

clawhub install tobiasbischoff/fizzy-cli

If the CLI is not installed:

Install command

npx clawhub@latest install tobiasbischoff/fizzy-cli

Or install with OpenClaw CLI:

Install command

openclaw skills install tobiasbischoff/fizzy-cli

or paste the repo link into your assistant's chat

Install command

https://github.com/openclaw/skills/tree/main/skills/tobiasbischoff/fizzy-cli

What This Skill Does

fizzy-cli is a command-line interface for the Fizzy kanban platform. It covers authentication and full CRUD operations on boards, cards, comments, tags, columns, users, and notifications. Output can be formatted as tables, JSON, or plain text for scripting.

It exposes all Fizzy board operations to shell scripts and automation pipelines where a browser-based UI is not practical.

When to Use It

  • Creating kanban cards without opening a browser
  • Scripting nightly triage of unread notifications
  • Moving cards between columns as part of a CI pipeline
  • Batch-creating boards and columns during project setup
  • Querying card lists and piping output to other shell tools
View original SKILL.md file
# 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.

Example Workflow

Here's how your AI assistant might use this skill in practice.

INPUT

User asks: Creating kanban cards without opening a browser

AGENT
  1. 1Creating kanban cards without opening a browser
  2. 2Scripting nightly triage of unread notifications
  3. 3Moving cards between columns as part of a CI pipeline
  4. 4Batch-creating boards and columns during project setup
  5. 5Querying card lists and piping output to other shell tools
OUTPUT
Use the fizzy-cli tool to authenticate and manage Fizzy kanban.

Share this skill

Security Audits

VirusTotalBenign
OpenClawBenign
View full report

These signals reflect official OpenClaw status values. A Suspicious status means the skill should be used with extra caution.

Details

LanguageMarkdown
Last updatedFeb 27, 2026