Fizzy看板命令行工具

技能简介

fizzy-cli 是 Fizzy 看板平台的官方命令行工具，支持在终端完成认证、配置及看板资源的完整生命周期管理。通过该工具可脱离浏览器直接操作卡片、评论、标签、列、用户和通知，适合批量处理与自动化场景。

能做什么

• 使用 Token 或邮箱验证码完成 CLI 登录
• 创建、更新、删除看板及卡片
• 为卡片添加图片附件与评论
• 移动卡片状态（归档、恢复、暂缓）
• 管理标签、列、成员与未读通知
• 输出 JSON 或纯文本格式供脚本解析

使用说明

1. 安装

原始文档未提供安装指令，需手动获取 fizzy-cli 二进制文件并加入系统 PATH。常见方式：

# macOS/Linux (示例)
curl -L https://github.com/fizzy/cli/releases/latest/download/fizzy-cli-$(uname -s)-$(uname -m) -o /usr/local/bin/fizzy-cli
chmod +x /usr/local/bin/fizzy-cli

2. 认证与配置

# Token 登录
fizzy-cli auth login --token $FIZZY_TOKEN

# 邮箱魔法链接（非交互式需补 --code）
fizzy-cli auth login --email user@example.com

# 设置默认账户与基础地址
fizzy-cli config set --base-url https://app.fizzy.do --account 897362094

# 验证状态
fizzy-cli auth status
fizzy-cli account list

3. 常用操作示例

# 看板
fizzy-cli board list
fizzy-cli board create --name "Roadmap"

# 卡片
fizzy-cli card list --board-id <board-id>
fizzy-cli card create --board-id <board-id> --title "Add dark mode" --description "Switch theme"
fizzy-cli card update <card-number> --title "Updated"
fizzy-cli card not-now <card-number>
fizzy-cli card close <card-number>

# 评论
fizzy-cli comment list <card-number>
fizzy-cli comment create <card-number> --body "Looks good"

# 其他资源
fizzy-cli tag list
fizzy-cli column list --board-id <board-id>
fizzy-cli notification list --unread

4. 输出格式切换

fizzy-cli board list --json    # 原始 API JSON
fizzy-cli board list --plain   # 稳定行输出

输入与输出

见下方输入与输出表格。

风险提示

• Token 与配置文件存储于本地 ~/.config/fizzy/config.json，注意权限控制避免泄露
• 删除看板或卡片操作不可逆，建议先导出备份
• 非交互环境使用邮箱登录时必须提供 --code 参数，否则流程挂起
• 多账户切换时需显式指定 --account 或提前写入配置，防止误操作其他空间数据

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/tobiasbischoff/fizzy-cli/SKILL.md
来源类型：GitHub 仓库