emanuele-em/kanzo

Kanzo is a kanban board in your browser and an MCP server in one small program, so you and your coding agents work on the same tasks. The whole board is one folder, and a private git repo keeps it in step on every machine you use: no account, no server.

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

For macOS and Linux, including every Raspberry Pi. Or with Cargo:

cargo install kanzo

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

n adds a task, / or ⌘K searches every project, Tab moves to the description, ⌘↵ saves and closes, Esc cancels.

Paste or drop an image into a task or a comment to attach it, as in ChatGPT. Agents get its file path and can open it.

When a new version is out, the sidebar offers it: one click installs it and restarts the board.

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 moves the card to doing and comments as it works. It finds the right project from the git remote of the repo it works in; link more repos to a project from its ⋯ menu.

A laptop, a desktop, a Raspberry Pi: they all share one board through a private git repo you own.

1. Create an empty private repo on GitHub, or anywhere git can push.
2. Press the sync button in the sidebar 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, press 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, click its name at the bottom of the sidebar.

Everything lives in ~/kanzo: the board in kanzo.db, settings in config.toml. Use another folder with --home or 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
statuses = ["todo", "doing", "review", "done"]   # new tasks go first, the last counts as done
mcp_http = true        # MCP at /mcp

Measured on an Apple M4.

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}