kablan
v0.10.8
Published
NPX wrapper around the Kablan server and its MCP task server
Maintainers
Readme
Kablan
Run coding agents — Claude Code, Codex, Gemini CLI, Amp and others — against your repositories from a board, and watch them work.
Each task gets its own git worktree and its own branch, so several agents can run at once without standing on each other. You follow the conversation, review the diff, start the project's dev server, and merge or open a PR when it looks right.
Run it
npx kablanNothing to install. This downloads the binary for your platform, caches it under ~/.kablan/bin,
and opens Kablan in your browser.
Install it as an app (macOS)
npx kablan --installPuts Kablan.app in ~/Applications. Opening it starts Kablan in the background — no terminal
window — and opens your browser. Output goes to ~/Library/Logs/Kablan/kablan.log.
Because the bundle is assembled on your machine rather than downloaded, macOS does not quarantine it: no "unidentified developer" prompt, and nothing to notarise.
Installing stops every copy of Kablan that is already running first — a surviving process keeps
serving the version it started with, which makes an update look like it did nothing. What it
stopped is printed, and appended to ~/Library/Logs/Kablan/install.log. A server you built
yourself is left alone.
- Update:
npx kablan@latest --install - Remove:
npx kablan --uninstall(cached binaries stay in~/.kablan/bin)
What you need
- Node 18 or newer, to run this wrapper.
- A coding agent, already authenticated. Kablan drives each agent's own CLI, so it uses the subscription you already have and never sees your model credentials.
- Git. Every attempt is a worktree on its own branch.
Platforms: macOS on Apple silicon and Intel, Linux x64, Windows x64.
Environment
| Variable | What it does |
| --- | --- |
| PORT | Port to serve on. Defaults to one the OS picks. |
| HOST | Host to bind. Defaults to 127.0.0.1. |
| KABLAN_LOCAL=1 | Use binaries from npx-cli/dist/ instead of a release, for development. |
| KABLAN_DEBUG=1 | Verbose wrapper output. |
MCP
npx kablan --mcpRuns the MCP task server on stdio, so an agent can create and update Kablan tasks itself.
About
Kablan is a fork of Vibe Kanban by Bloop AI, used under the Apache License 2.0. It is not affiliated with or endorsed by Bloop AI.
Source and issues: github.com/AmarShaked/kablan.dev
