Install

mikan ships as the scoped npm package @takemo101/mikan.

Requirements

• Bun available at runtime. The published binary is a bundled Bun entrypoint.
• A terminal for the CLI and TUI.
• Optional: an MCP-capable AI coding agent if you want agent integration.

From npm

npm install -g @takemo101/mikan
mikan --help

One-off use without a global install:

npx @takemo101/mikan init
# or
bunx @takemo101/mikan init

Verify

mikan --help
mikan init --help
mikan tui --help
mikan mcp --help

To test in a scratch project:

mkdir /tmp/mikan-demo
cd /tmp/mikan-demo
mikan init
mikan add "First Issue" --status ready
mikan list

Upgrade

npm install -g @takemo101/mikan@latest

If you registered mikan with an MCP client, restart that client after upgrading so it picks up the current tool definitions.

Uninstall

npm uninstall -g @takemo101/mikan

mikan stores project data inside each repo's .mikan/ directory. Removing the npm package does not delete project Issue files.

Next

• Quickstart — create your first board.
• CLI — command reference.
• MCP & Skills — connect coding agents.