kanzo README

项目的 README,来自 github.com/emanuele-em/kanzo。合并为一个 markdown 文件:README.md。

kanzo: a tiny kanban board for you and your coding agents

CI crates.io AGPL-3.0

English | 简体中文

Kanzo is a kanban board in your browser and an MCP server in one 4.7 MB program, so you and your coding agents work on the same tasks: on one computer, or on one board shared by all of them. No account, no server, no setup: run kanzo and it works.

You never edit a file. Everything is done in one of three places:

The Kanzo board: agents move cards while you watch, ⌘K finds a task in any project, a task is made to wait on another, two selected tasks are dragged together, a list groups the tasks by status, the sidebar folds, Laptop A shares the board and Laptop B joins it

Install

[!TIP] Just ask your agent: "install Kanzo from github.com/emanuele-em/kanzo."

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

For macOS and Linux, including every Raspberry Pi. On Windows, in PowerShell:

powershell -ExecutionPolicy Bypass -c "irm https://github.com/emanuele-em/kanzo/releases/latest/download/kanzo-installer.ps1 | iex"

Both add Kanzo to your PATH, for terminals you open from then on. To use it in the one you installed from, run source $HOME/.cargo/env (env.fish in fish), or open a new one.

Or download the Windows zip from the latest release and put kanzo.exe in a folder named bin on your PATH, like %USERPROFILE%\.cargo\bin: the board updates itself only there.

Every release is signed by GitHub: check a download with gh attestation verify <file> --repo emanuele-em/kanzo. Or with Cargo:

cargo install kanzo

Start

[!TIP] Just ask your agent: "start Kanzo and keep it running at login."

kanzo

The board opens at http://localhost:4242. That's all the setup there is: the first run creates ~/kanzo, and the whole board lives in it.

Key Does
n New task
/ or ⌘K Search every project
f Filter the board; ↵ keeps the filter
Tab Move to the description
⌘↵ Save and close
Esc Keep what you typed in a description or tags; cancel other fields

Use the board

[!TIP] Just ask your agent: "mark kanzo#12 as human, and set its URL to github.com/acme/api/pull/482."

Connect your agents

[!TIP] Just ask your agent: "add Kanzo as your MCP server," then restart it.

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

Other MCP clients: run kanzo mcp (apps like Raycast need the full path, from which kanzo), or use the running board at http://localhost:4242/mcp.

Then ask: "take the next task from kanzo and do it." The agent:

A task open on the board, with Claude Code's comments, one saying how to resume its session, and a reply

Park ideas in a backlog

Turn on Backlog in Settings for a column agents leave alone, until you move its tasks to todo.

The board with the Backlog column on, left of Todo

Make a task wait on others

[!TIP] Just ask your agent: "make kanzo#12 wait on #10 and #11."

A task's panel with log typed in Waits on, offering two tasks to pick, beside a dimmed card that says Waits on #7

[!TIP] Just ask your agent: "take the next kanzo task tagged billing," or "list what's left in kanzo with tag:billing."

The board's filter (f), search (/) and the filter of list_tasks and next_task all understand the same words, like on GitHub:

The board filtered by a saved tag:backend chip and is:waiting in the filter box, with the two matching tasks, each saying what it waits on
Qualifier Finds Example
tag: that exact tag tag:bug, tag:"needs review"
status: a column status:doing
project: a project project:api
title:, description:, url:, comment: text in that field title:login, comment:"on hold"
id:, comments:, images: a number, or a range id:12, comments:>2, images:1..3
created:, updated: a date, or a range created:2026-11-05, updated:<2026-01-31
is:human tasks for you, not agents -is:human
is:waiting tasks waiting on unfinished ones -is:waiting
has:, no: description, tags, url, comments or images has:url, no:tags

Anything else is plain text. Use quotes for a phrase, "on hold", or to look for text that reads like a qualifier, "tag:bug". Agents can't filter through a property you've hidden in Settings.

Use it on several computers

Two ways, neither with any setup: share one board live, or sync it between machines.

Share it live

[!TIP] Just ask your agent: "share my Kanzo board" on one computer, and "join the Kanzo board at 192.168.1.20" on the others.

Several computers, one board, at the same time: everyone sees the same tasks, and every agent works on them.

  1. On the computer with the board, click the share icon next to New task and turn on Share this board. Copy an address it shows.
The share popover on the computer with the board: sharing is on, with its addresses to copy and the computers connected
  1. On each other computer, click the share icon, paste the address and click Join.
The share popover on another computer: connected to the shared board, with a Leave button

Nothing restarts and nothing needs configuring. Their board shows the shared one, and their agents use it through the same kanzo mcp, still finding the project from the repo they work in. Turn sharing off, or click Leave, at any time.

From a terminal, or for an agent, it's kanzo share on and kanzo join <address>, then kanzo share off and kanzo leave.

The same two commands work wherever the board lives; only the address changes:

Your computer shares its board. Others join it from theirs, on the same network.

flowchart LR
  B["💻 Laptop B<br><code>kanzo#nbsp;join#nbsp;192.168.1.20</code>"] -- home network --> A["💻 Laptop A<br><i>192.168.1.20</i><br><code>kanzo#nbsp;share#nbsp;on</code>"]

A Raspberry Pi keeps the board. Every computer joins it, and none has to stay on.

flowchart LR
  A["💻 Laptop A<br><code>kanzo#nbsp;join#nbsp;192.168.1.50</code>"] -- home network --> pi["🍓 Raspberry Pi<br><i>192.168.1.50</i><br><code>kanzo#nbsp;share#nbsp;on</code>"]
  B["💻 Laptop B<br><code>kanzo#nbsp;join#nbsp;192.168.1.50</code>"] -- home network --> pi

The Raspberry Pi is somewhere else, over the internet. Put a VPN on the Pi and on each computer, like Tailscale, NetBird or WireGuard: kanzo share on then shows the Pi's VPN address too.

flowchart LR
  A["💻 Laptop A<br><code>kanzo#nbsp;join#nbsp;100.101.32.7</code>"] -- VPN --> net(("🌐 Internet"))
  B["💻 Laptop B<br><code>kanzo#nbsp;join#nbsp;100.101.32.7</code>"] -- VPN --> net
  net -- VPN --> pi["🍓 Raspberry Pi<br><i>100.101.32.7</i><br><code>kanzo#nbsp;share#nbsp;on</code>"]

On a Pi, kanzo service install keeps the board running after a restart. There are no logins: share only on a network you trust.

Sync it between machines

[!TIP] Just ask your agent: "sync my Kanzo board," or the first time, "set up Kanzo sync with github.com/you/kanzo-data."

To carry the board between machines you use one at a time, a private git repo you own keeps it in step.

  1. Create an empty private repo on GitHub, or anywhere git can push.
  2. Click Settings at the bottom of the sidebar, choose Sync and paste its URL. Kanzo makes ~/kanzo a git repo and pushes the board.
  3. On each other machine, do the same with the same URL: Kanzo offers to use the board that's already there.

From then on, choose Sync, or run kanzo sync, when you switch machines. It commits the board and pulls or pushes it, and it's safe while the board and your agents are running. If both machines changed the board, Kanzo asks which one to keep. To move to another repo, change it in Settings, under Sync.

Commands

Command Does
kanzo Starts the board at http://localhost:4242 and opens it; --port for another port, --no-open to not open it
kanzo service install Keeps the board running and starts it at login; uninstall removes it
kanzo mcp The MCP server for agents: they start it, not you
kanzo share on Shares the board with the other computers on your network; off stops, while the board keeps running
kanzo join <ip> Uses the board another computer shares, from this one's board and agents; kanzo leave goes back
kanzo sync Commits the board and pulls or pushes it; --repo <url> sets the repo, --keep-local or --keep-remote when both sides changed
kanzo export Prints the board as Markdown; -f json for JSON, -p <project> for one project, -o <file> to save it
kanzo update Installs the latest release and restarts the board's service; the board offers new versions too
kanzo init Creates the data folder; the first run does this too
kanzo --version Prints the version

Every command takes --home <dir> to use another data folder.

Settings

[!TIP] Just ask your agent: "run Kanzo on port 4300."

Everything lives in ~/kanzo: the board in kanzo.db, settings in config.toml. You never need to open either; use another folder with --home or KANZO_HOME.

port = 4242
listen = "127.0.0.1"   # sharing opens the board to your network; "0.0.0.0" keeps it open
mcp_http = true        # MCP at /mcp
editor = "/usr/local/bin/cursor"   # opens file:/// links; on macOS, your text editor without it

These settings stay on each machine: kanzo sync leaves them out.

Settings on the board:

Small and fast

Program 4.7 MB, SQLite included
Memory 5 MB idle, 12 MB with 3,000 tasks
Start 3 ms
Board of 3,000 tasks 17 ms to load in the browser
Agents' tool list about 1,000 tokens, once per session
Agents' replies 10 to 60 tokens of plain text

Measured on an Apple M4.

License

AGPL-3.0: use it, change it and share it; if you offer a changed version over a network, share its source too. To help, see CONTRIBUTING.

mcp-name: io.github.emanuele-em/kanzo

kanzo (emanuele-em/kanzo)

正在搜索数据库…

1.2K ·GitHub
这是什么?Kanzo 是一个可自托管的看板,同时也是一个 MCP 服务器,让你和你的编程智能体共同处理同一批任务:可以在一台电脑上使用,也可以多人共用同一个看板。
这是网页应用、命令行工具还是 MCP 服务器?三者合一,都包含在一个 4.5 MB 的可执行文件中:一个可以在浏览器中打开的看板、一个供智能体连接的 MCP 服务器,以及一个用于终端和脚本的 kanzo 命令。
如何安装和启动?可以通过 macOS/Linux 安装脚本、Windows 压缩包或 Cargo 安装,然后直接运行 `kanzo`。首次运行会创建 ~/kanzo 文件夹,看板随即打开,无需任何配置。
使用前是否需要先安装数据库或做其他设置?不需要。SQLite 已内置在这个单一可执行文件中,因此无需注册账号,也无需单独的服务器,使用前不必做任何配置。
通过网络共享看板默认安全吗?实时共享的看板没有登录系统,因此只应在可信的网络中共享;如果要跨地点通过互联网使用,需要自行添加 Tailscale 或 WireGuard 等 VPN。
它也能在 Raspberry Pi 和 Windows 上运行吗?可以。它支持 macOS 和 Linux,包括所有型号的 Raspberry Pi,也可以在 Windows 上通过 PowerShell 或可下载的压缩包运行。
我的看板数据实际保存在哪里?所有数据都保存在你电脑上的 ~/kanzo 文件夹中:看板本身存于 kanzo.db,设置存于 config.toml,不涉及任何云端账号。
许可证条款是什么?Kanzo 采用 AGPL-3.0 许可证:你可以自由使用、修改和分享它;但如果你通过网络提供修改后的版本,则必须同时公开该版本的源代码。
编程智能体如何连接到 Kanzo?智能体可以作为 MCP 客户端运行 `kanzo mcp`,或被添加为 MCP 服务器。连接后,它们会领取任务、把卡片移到“进行中”,并在工作过程中留下评论。
多台电脑能否共用同一个看板?可以,有两种方式且无需额外设置:一是通过局域网或 VPN 实时共享同一个看板,让所有智能体看到相同的任务;二是通过私有 git 仓库在多台机器之间同步看板。
它实际运行得有多快、占用多少资源?启动约需 2 毫秒,空闲时占用 4.5MB 内存,在浏览器中加载一个包含 3,000 个任务的看板仅需 17 毫秒。以上数据是在 Apple M4 上测得的。
“Backlog”列有什么用?在设置中开启 Backlog 后,会新增一列,智能体会忽略这一列。你可以先把想法放在这里,等需要时再手动移到“待办”。
大小
19.9 MB
星标
1.2K
时长
24天
提交 · 90 天