Minicode
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.
Last verified:
What is Minicode?
MiniCode is a lightweight terminal coding assistant designed for local development workflows. It provides a Claude Code-like workflow with a model-tool-loop architecture in a compact terminal user interface (TUI). The tool helps developers inspect code repositories, edit files with review-before-write approvals, run commands, track background tasks, and manage coding sessions that survive exits.
Key features include a card-style session layout, full multi-step tool execution loop within a single turn, standard unified diff view before writing files, path and command allowlist verification, and interception of dangerous actions. MiniCode supports extending workflows through local Skills (SKILL.md instructions) and Model Context Protocol (MCP) servers. It includes a built-in toolchain with 13 tools for file system management, command execution, and MCP helpers.
MiniCode is built for developers who want learning and experimentation with AI coding assistants, those who prefer terminal-first workflows, and users seeking a minimalist design focused on the core tool-calling execution loop. It supports TypeScript, Python, and Rust implementations. The tool is open-source and particularly useful for understanding agent architecture, custom tooling, and maintaining developer flow without context switching between terminal, editor, and browser.
The assistant handles long-context management with provider usage anchoring, auto-compact triggers, snip compact for safe history removal, context collapse summarization, and local storage for huge tool results. Sessions are stored as append-only JSONL logs per project, allowing resume, rename, fork, compact, and expiry cleanup operations.
Minicode pricing
Pricing model: Freemium
Free and open-source. MiniCode is available as an open-source project on GitHub with no paid tiers. The tool is completely free to use for local development, learning, and experimentation. Users only need to provide their own AI model API access (such as api.minimaxi.com with MiniMax-M2.7 model mentioned on the website).
Minicode pros
- Lightweight terminal-first design for local development
- Claude Code-like workflow in a compact implementation
- Full multi-step model-tool-loop in single turn
- Review-before-write approvals with unified diff view
- Path and command allowlist verification for safety
- Interception of dangerous actions built-in
- 13 built-in tools for file and command operations
- Local Skills support via SKILL.md instructions
- MCP server mounting for extended capabilities
- Sessions survive exits with JSONL append-only storage
- Resume, rename, fork, and compact session operations
- Usage-aware auto-compaction for long contexts
- Large tool outputs saved to local storage
- Full-screen TUI with transcript scrolling
- Open-source with TypeScript, Python, Rust implementations
Minicode cons
- Primarily designed for learning and experimentation
- Limited to local development workflows only
- Requires terminal familiarity to use effectively
- No cloud-based collaboration features
- MCP server setup requires manual configuration
- Skills require creating SKILL.md files manually
- No graphical interface beyond TUI
- Context compaction may lose some history details
- Background tasks registry is minimal
- No built-in IDE integration beyond terminal
Frequently asked questions about Minicode
What is MiniCode?
MiniCode is a lightweight terminal coding assistant for local development workflows. It provides a Claude Code-like workflow and architectural ideas in a much smaller implementation, built around a practical terminal-first agent loop with model-tool-loop architecture, TUI interface, and support for Skills and MCP protocols.
How do I install MiniCode?
To install MiniCode, navigate to the mini-code directory and run 'npm run install-local'. Then you can start it by typing 'minicode' in your terminal. The project is available on GitHub at LiuMengxuan04/MiniCode with TypeScript, Python, and Rust implementations.
What makes MiniCode different from other coding assistants?
MiniCode is specifically designed for learning and experimentation with a compact codebase centered around the main execution loop. It meets you where you code with a minimalist TUI design, provides safety through permission validation and code review in the primary execution pathway, and offers endless extensibility through local Skills and MCP servers.
How does the review-before-write feature work?
MiniCode shows a standard Unified Diff view before writing any files, allowing you to review changes before they're applied. This safety feature is built into the primary execution pathway along with path and command allowlist verification and interception of dangerous actions.
What are Skills and how do I use them?
Skills are local extensions that MiniCode discovers through SKILL.md instructions in your project. They allow you to extend workflows endlessly. MiniCode seamlessly mounts these local Skills along with Model Context Protocol (MCP) servers to expand capabilities beyond the built-in toolchain.
How do sessions work in MiniCode?
Every turn is appended to a per-project JSONL session log. Sessions survive exits and can be resumed with '--resume', selected via '/resume' picker, renamed, forked into clean branches, compacted, or cleaned up on expiry. The transcript is rebuilt from the stored event stream with append-only events and parent links.
What tools are built into MiniCode?
MiniCode includes 13 built-in tools: list_files, grep_files, read_file, write_file, edit_file, patch_file, modify_file, run_command, web_fetch, web_search, ask_user, load_skill, list_mcp_resources, read_mcp_resource, list_mcp_prompts, and get_mcp_prompt. These are centralized through a standardized tool protocol.
How does MiniCode handle long contexts?
MiniCode uses provider usage anchoring for context badges and auto-compact triggers. It offers snip compact for safe middle history removal, context collapse for summarizing spans, and saves huge tool results to local storage with preview. This includes provider usage plus estimated tail accounting.
Is MiniCode safe to use?
Yes, MiniCode prioritizes safety with permission validation and code review built into the primary execution pathway. It provides standard Unified Diff view before writing, path and command allowlist verification, and interception of dangerous actions, making safety an integral part of the workflow rather than an afterthought.
What programming languages does MiniCode support?
MiniCode has implementations available in TypeScript, Python, and Rust. The tool itself can work with code in any language since it provides file system management, command execution, and editing capabilities through its built-in toolchain, making it language-agnostic for the code you work on.