360 Secure SkillHub
360 安全技能中心

fizzy.do - have your agent read, understand and update your fizzy.do boards

通过 fizzy-cli 命令行工具完成 Fizzy 看板的认证、配置与日常操作，支持看板、卡片、评论、标签、列、用户和通知的查询、创建、更新与删除，并提供表格、--json、--plain 三种输出模式，便于脚本化工作流。

tobiasbischoff
tobiasbischoff
热度 79.10
最近更新 2026-05-11 15:48:49
分类：协作依赖：代码执行 / 读写文件 / 第三方 API应用场景：任务管理 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add fizzy-cli
Metadata
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 user@example.com
    • If non-interactive, pass --code ABC123.
  1. 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
  1. 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.