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/MiniCodeLast scanned: 5/12/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-05-12T06:40:14.329Z",
"semgrepRan": false,
"npmAuditRan": true,
"pipAuditRan": true
}MiniCode is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by LiuMengxuan04. 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. It has 953 GitHub stars.
Yes. MiniCode passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/LiuMengxuan04/MiniCode" and add it to your Claude Code skills directory (see the Installation section above).
MiniCode is primarily written in TypeScript. It is open-source under LiuMengxuan04 on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh MiniCode against similar tools.
No comments yet. Be the first to share your thoughts!
简体中文 | 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.