Installation
Requirements#
- Node.js
^22.19.0or>=24.11.0(theenginesfield ofpackage.json). better-sqlite3for board files. It is an optional dependency:npm install -g kanbo-clibrings it along, with a prebuilt binary for macOS, Linux — glibc (Debian, Ubuntu, …) and musl (Alpine) — and Windows, each for x64 and arm64. kanbo loads it only when a board file is actually opened, so a Postgres-only setup,kanbo capabilitiesandkanbo --helpwork even where it could not be installed. Opening a board file without it fails withCould not load better-sqlite3, which kanbo opens board files with, ….- For a shared board: a Postgres database you can create tables and roles in (Supabase works). See storage.
An older Node is refused before anything else runs: kanbo needs Node ^22.19.0 || >=24.11.0; this is Node ….
npm, globally#
npm install -g kanbo-cli
kanbo --versionThe npm package is named
kanbo-cli; the command it installs iskanbo.
Windows PowerShell. npm's global installs put a kanbo.ps1 shim on your PATH alongside kanbo.cmd. If PowerShell answers kanbo : File …\kanbo.ps1 cannot be loaded because running scripts is disabled on this system, that is its execution policy, not kanbo — it blocks every npm-installed CLI's .ps1 shim the same way. Fix it once for your own account: Set-ExecutionPolicy -Scope CurrentUser RemoteSigned in PowerShell (no admin needed for CurrentUser). Command Prompt is unaffected: kanbo.cmd runs there either way.
npx, without installing#
npx -y -p kanbo-cli kanbo --helpnpx installs kanbo-cli and its optional better-sqlite3 the same way npm install does, into a throwaway cache. This works for one-off commands. For agents, a global install (or a project-local one) is better: MCP clients start kanbo mcp often, and each npx start resolves packages again — on a slow connection, or a registry outage, that start fails.
In a project#
npm install --save-dev kanbo-cli
npx kanbo init --filenpx kanbo … then runs the project's copy. MCP registrations written by kanbo connect (or kanbo init --mcp) call kanbo, so it must be on the PATH of the agent — either install globally or change the command in the registration to npx with args: ["kanbo", "mcp"].
From source#
git clone https://github.com/Krowli/kanbo.git
cd kanbo
npm install
npm run build
npm link # puts `kanbo` on your PATH, pointing at this checkout
kanbo --helpnpm run build writes dist/cli.cjs (the command), dist/lib/ (the library, ESM and CJS with types) and dist/page/ (the board page kanbo serve answers with). To make a tarball you can install elsewhere: npm pack, then npm install -g ./kanbo-cli-0.2.1.tgz.
Upgrading#
npm install -g kanbo-cli@latestA newer build may add columns or tables to the board. When it does:
- A board file (
kanbo init --file) keeps working for reads; writes are refused with exit3andThis board file was made by an older kanbo. Run kanbo migrate.Runkanbo migratein the project. - An external Postgres board is refused entirely (exit
3) until you runkanbo migrate, and thenkanbo roles apply, with the owner's connection string. See storage.
kanbo migrate applies only what is pending and is safe to run again. The changelog says when an upgrade needs it.
Uninstalling#
First take out what kanbo init wrote — the instruction blocks and the kanbo MCP entries, in the project and in your own files — while kanbo is still installed:
cd your-project
kanbo uninstall # shows what it will remove, then asks; --yes to skip the question--project or --global limits it to one scope. Nothing else in those files is touched. Then remove the package:
npm uninstall -g kanbo-cliYour boards are not touched: a board file stays in the project's .kanbo/, and a Postgres board stays in its database. To remove a project's binding too, run kanbo uninstall --purge; it deletes the board file only if you confirm a question naming it in a terminal (--yes does not answer that one).