mikanLocal-first Issue board for AI-assisted development

A tiny Markdown-backed board shared by humans, CLIs, TUIs, MCP clients, and coding agents — without a server, database, scheduler, or workflow engine.

Get Started

Install

View on GitHub

🍊

Markdown source of truth

Every Issue is a readable Markdown file under .mikan/. Status is the containing directory, so state stays easy to diff, edit, and commit.

🧭

Small primitive CLI

Create, list, show, update, move, and append Issue context with focused commands that are safe for humans and agents.

🖥️

Keyboard-first TUI

Open a dense board, inspect full-page Markdown details, append Notes, move Issues, and archive completed context from the terminal.

🌐

Local Browser board

Open a local Web board with mikan browser. It binds to 127.0.0.1, opens on demand, and supports a Markdown detail modal, appends, and drag-and-drop Status moves — no shared server.

🔌

Stdio MCP for agents

Register mikan with common AI coding agents so they can read and update the same local Issue files through explicit tools.

🧩

Skills without a runtime

Install agent guidance for supported clients. mikan does not model agents, spawn workers, or schedule work.

🔔

Optional local hooks

Poll Status transitions for lightweight local automation. Hook failures are logged as warnings and never become authoritative state.