MiniCode Beta 1.0 is available

AI-powered coding assistant
built for developers

Work with large language models directly in your terminal. Build, debug, and ship with an execution loop that keeps you in control. Describe what you need, and MiniCode handles the tools.

View on GitHub Read Documentation Rust Version Python Version

Multi-language roadmap: Rust and Python versions are now available.

api.minimaxi.com
MiniCode
Terminal coding assistant with a card-style session layout.
mini-code ~/code/mini-code [session] local [provider] api.minimaxi.com [model] MiniMax-M2.7 [messages] 3 [events] 2 [skills] 13 [mcp] 1
cwd: ~/code/mini-code | extra allowed dirs: ~/code/claude-code, ~/cod...
2 events
session feed
.
assistant
Hello! 👋

I'm mini-code, your terminal coding assistant. I can help you with:
  • 🔍 Inspecting code and repositories
  • 📝 Writing, editing, and modifying files
  • 🔨 Running development commands
  • 🖼️ Generating images (with MiniMax AI)
  • 📄 Working with various file formats (PDF, DOCX, XLSX, PPTX)
  • 🎯 Following skill workflows (frontend-dev, fullstack-dev, flutter-dev, etc.)
What would you like to work on today?
prompt
prompt Enter send | /help commands | Esc clear | Ctrl+C exit
mini-code> Ask for code, files, tasks, or MCP tools
Ready
tools on | skills on

Built with modern architectures

Model-Tool-Loop Terminal UI MCP Protocol Diff Review Local Skills

Inspired by Claude Code

MiniCode is designed as an architectural reference implementation. It intentionally strips away bloated platform features to focus entirely on the core AI-developer interaction loop. It is the perfect fit if you are looking for:

A lightweight assistant

Instead of a heavy IDE platform, getting a standalone assistant focused purely on the coding workflow.

Clean terminal UI

Native tool calling, transcript scrolling, and complete command workflows without leaving the terminal.

Readable codebase

A minimal project structure extremely suitable for reading, secondary development, and private customization.

Reference architecture

For learning how modern AI agent loops (like Claude Code) are built under the hood.

Meets you where you code

A minimalist design focusing on the core tool-calling execution loop, providing safety and high extensibility.

Core execution loop

MiniCode manages a full multi-step tool execution loop (model -> tool -> model) in a single turn, providing seamless context processing without leaving the terminal.

  • Full-screen TUI with transcript scrolling
  • Separation of progress and final answers
  • Feedback injection upon rejection

You're in control

Safety shouldn't be an afterthought. MiniCode brings permission validation and code review straight into the primary execution pathway.

  • Standard Unified Diff view before writing
  • Path and command allowlist verification
  • Interception of dangerous actions

Skills & MCP

Extend capabilities endlessly. MiniCode discovers local SKILL.md instructions and seamlessly mounts stdio Model Context Protocol (MCP) servers.

Built-in Toolchain

Local file system management, command execution, and MCP helpers are centralized through a standardized tool protocol, ready to be called by the model at any time.

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 get_mcp_prompt

Architecture

MiniCode is not a bloated platform. It's a precisely structured codebase centered around the main execution loop.

src/agent-loop.ts

The core multi-turn tool-calling loop that drives the entire asynchronous conversational logic.

src/permissions.ts

The security sentinel handling path allowlists, command reviews, and intercepting unauthorized writes.

src/mcp.ts

The external connector managing MCP client connections and wrapping remote tool functions for local execution.

src/background-tasks.ts

A minimal registry separating ephemeral foreground tools from persistent background shell tasks (like dev servers).