A lightweight terminal coding assistant with Claude Code-like workflow, tool loop, and TUI architecture, built for learning and experimentation. Multi-language support: TypeScript , Python and Rust implementations available now.
# Add to your Claude Code skills
git clone https://github.com/LiuMengxuan04/MiniCodeGuides for using ai agents skills like MiniCode.
Last scanned: 5/12/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-05-12T06:40:14.329Z",
"semgrepRan": false,
"npmAuditRan": true,
"pipAuditRan": true
}简体中文 | Usage Guide | DeepWiki | Architecture | Contributing | Roadmap | License
MiniCode is a lightweight terminal coding assistant for local development workflows.
It provides Claude Code-like workflow and architectural ideas in a much smaller implementation, making it especially useful for learning, experimentation, and custom tooling.
MiniCode is built around a practical terminal-first agent loop:
The project is intentionally compact, so the control flow, tool model, and TUI behavior remain easy to understand and extend.
Summaries are based on the main repository and multi-language branch commit history. For the broader contributor list, please refer to the repository commit history.
https://liumengxuan04.github.io/MiniCode/MiniCode is a good fit if you want:
model -> tool -> model loop.SKILL.md, plus MCP tools/resources/prompts over stdio or remote HTTP.Full command references, configuration examples, session details, and Skills/MCP usage have moved to the Usage Guide.
cd mini-code
npm install
npm run install-local
The installer asks for the model name, ANTHROPIC_BASE_URL, and ANTHROPIC_AUTH_TOKEN. Configuration is stored in:
~/.mini-code/settings.json~/.mini-code/mcp.jsonYou can override the config directory with MINI_CODE_HOME and the launcher directory with MINI_CODE_BIN_DIR. See Installation Details for more.
Run the installed launcher:
minicode
Run in development mode:
npm run dev
Run in offline demo mode:
MINI_CODE_MODEL_MODE=mock npm run dev
/help: show interactive help./tools: list available tools./skills: list discovered skills./mcp: show MCP connection status./status: show session and context status./init: scaffold .mini-code/ and MINI.md for the current project./memory: inspect the layered memory files loaded for the current turn./model / /model <name>: inspect or switch the model./resume: open the session picker./compact: manually compact the context.Management commands include minicode mcp ... and minicode skills .... See Commands for the full reference.
npm run check
npm test
MiniCode is intentionally small and pragmatic. The goal is to keep the architecture understandable, hackable, and easy to extend.
No comments yet. Be the first to share your thoughts!