KnBn

A TypeScript-first tool for managing advanced TODOs, in a Kanban style, locally in your project.

This is an early, work-in-progress version of the project. Use accepting risk of breaking changes.

Overview

KnBn project contains four main packages, each in their own repo.

• knbn-core: Core logic and types
• knbn-web: Browser-based management UI
• knbn-mcp: AI assistant integration via MCP
• knbn-cli: Command-line tools for managing boards

Usage

Any of the following options will work. Default board file is .knbn, but you can create as many as you like, with any name (eg. project.knbn).

Web

npx knbn-web
# or
npm i -g knbn-web
knbn-web 

This will open the web interface in your default browser at http://localhost:9000, but you can specify a custom port with -p option.

MCP Server

Configure your MCP client to use knbn-mcp. For example, with Claude Code:

claude mcp add knbn -- npx knbn-mcp

The server config JSON looks like:

{
  "mcpServers": {
    "knbn": {
      "command": "npx",
      "args": ["knbn-mcp"]
    }
  }
}

CLI

For basic CLI usage, run via npx or install globally.

npx knbn-cli
# or
npm i -g knbn-cli
knbn-cli