Kanzo

Kanzo 是一个小巧的程序，既是浏览器中的看板，也是 MCP 服务，让你和编码 Agent 能处理相同的任务。整个看板就是一个文件夹，私有 git 仓库会让你使用的每台机器上的看板保持同步：无需账户，也无需服务端。

安装

curl -LsSf https://github.com/emanuele-em/kanzo/releases/latest/download/kanzo-installer.sh | sh

适用于 macOS 和 Linux，包括所有 Raspberry Pi。每个版本均由 GitHub 签名：使用 gh attestation verify <file> --repo emanuele-em/kanzo 验证下载内容。也可以使用 Cargo：

cargo install kanzo

使用

命令	作用
kanzo	在 http://localhost:4242 启动看板并打开它；使用 --port 指定其他端口，使用 --no-open 不打开页面
kanzo service install	让看板保持运行并在登录时启动；uninstall 会将其移除
kanzo mcp	为 Agent 提供的 MCP 服务：由它们启动，而不是你
kanzo sync	提交看板并拉取或推送；--repo <url> 设置仓库，双方都有更改时使用 --keep-local 或 --keep-remote
kanzo export	将看板输出为 Markdown；使用 -f json 输出 JSON，-p <project> 指定单个项目，-o <file> 保存到文件
kanzo update	安装最新版本并重启看板服务；看板也会提示新版本
kanzo init	创建数据文件夹；首次运行时也会执行此操作
kanzo --version	输出版本

每条命令都可使用 --home <dir> 指定其他数据文件夹。

按 n 添加任务，按 / 或 ⌘K 搜索所有项目，按 Tab 移至描述栏，按 ⌘↵ 保存并关闭，按 Esc 取消。

需要一个存放想法的地方？在设置中开启「Backlog」栏，位置在侧边栏底部：在你将其中的任务移至 todo 前，Agent 不会处理这些任务。

像在 ChatGPT 中一样，将图片粘贴或拖入任务或评论即可添加附件。Agent 会获取图片的文件路径并打开它。

有新版本时，侧边栏会显示提示：点击一次即可安装并重启看板。

连接你的 Agent

claude mcp add kanzo --scope user -- kanzo mcp   # Claude Code
codex mcp add kanzo -- kanzo mcp                 # Codex

其他 MCP 客户端：运行 kanzo mcp（Raycast 等应用需要完整路径，可通过 which kanzo 获取），或使用正在运行的看板：http://localhost:4242/mcp。

然后询问：“从 kanzo 领取下一个任务并完成它。”Agent 会将卡片移至 doing，并在工作过程中发表评论。它会根据其工作目录所对应仓库的 git 远程地址找到正确的项目；可通过项目的 ⋯ 菜单关联更多仓库。

## 在每台设备上使用同一看板

笔记本电脑、台式机、Raspberry Pi：它们通过你自己的私有 Git 仓库共享同一个看板。

1. 在 GitHub 上创建一个空的私有仓库，也可以选用任何支持 Git 推送的地方。
2. 点击侧边栏底部的 Settings，选择 Sync 并粘贴仓库 URL。Kanzo 会将 ~/kanzo 设为 Git 仓库，并推送看板。
3. 在其他每台设备上，用相同的 URL 执行相同操作：Kanzo 会提供使用已有看板的选项。

此后，切换设备时选择 Sync，或运行 kanzo sync。它会提交看板并拉取或推送，看板和 Agent 正在运行时也可以安全操作。如果两台设备都修改了看板，Kanzo 会询问你要保留哪一份。要切换到其他仓库，请在 Settings 的 Sync 下进行更改。

Sync 用于切换设备：在一台设备上工作、同步，然后切换到另一台设备。若要让多台设备上的 Agent 同时工作，请在你信任的网络上运行一个设置了 listen = "0.0.0.0" 的看板，并让每个 Agent 连接到 http://<host>:4242/mcp，同时按名称传入项目。

设置

所有内容都位于 ~/kanzo：看板在 kanzo.db 中，设置在 config.toml 中。使用 --home 或 KANZO_HOME 指定其他文件夹。

port = 4242
listen = "127.0.0.1"   # "0.0.0.0" opens the board to your network: no logins, so only on one you trust
mcp_http = true        # MCP at /mcp

小巧快速

程序	4.1 MB，包含 SQLite
内存	空闲时 4.5 MB，包含 3,000 个任务时 8 MB
启动	2 ms
包含 3,000 个任务的看板	浏览器加载需 17 ms
Agent 的工具列表	每个会话一次，约 900 个 token
Agent 的回复	10 到 60 个纯文本 token

在 Apple M4 上测得。

许可证

AGPL-3.0：使用、修改和分享；如果通过网络提供修改后的版本，也必须分享其源代码。如需协助，请参阅 CONTRIBUTING。

_{mcp-name: io.github.emanuele-em/kanzo}