← MiniLabs
Project 01

MiniCode

Live

A coding agent CLI for the terminal — every step visible, every sensitive action gated behind your permission.

MiniCode is a coding agent CLI on the frozen MiniCore kernel — zero-dependency (Bun only). Interactive sessions run as a fullscreen TUI; one-shot and CI runs flow as a machine-readable JSONL stream. File changes are jailed to the workspace, shell commands are guarded by a bash-guard, and sensitive actions always pass through your permission — with shadow-git checkpoints and a mutation journal so resume never re-does work blindly.

01Install

From zero to usable in a few steps.

  1. Prerequisite — install Bun (≥ 1.1.13). This is the runtime; npm is only for distribution.
    curl -fsSL https://bun.sh/install | bash
  2. Install MiniCode from npm.
    npm install -g minicode-ai
  3. Run it — a setup wizard appears if no provider is configured, then the interactive TUI.
    minicode
  4. Or one-shot (headless).
    minicode "review this change"

On Windows, install Bun via PowerShell first, then continue. The full guide (OAuth login, sandbox, updates) is under Documentation → Installation.

02Capabilities

  • Zero-dependency (Bun), frozen MiniCore kernel
  • Path jail + bash guard + sandbox (Docker / OS)
  • WorkMode (DISCUSS/PLAN/BUILD) + PermissionMode (AUTO/ASK)
  • MCP, LSP, sub-agents (delegate_task), shadow-git checkpoints
  • Durable mutation journal + resume without blind redo

03Code & documentation

Repo, releases, and full documentation one click away.