MiMo-Code

XiaomiMiMo/MiMo-Code

MiMo Code: Where Models and Agents Co-Evolve

12k
Stars
1.1k
Forks
732
Open issues
63
Watchers
TypeScript MITLast pushed Jul 7, 2026

Overview

A terminal-native AI coding assistant that reads and writes code, runs commands, manages Git, and uses persistent memory to understand projects across sessions. It supports MiMo Auto for limited-time use and connects to OpenAI-compatible APIs.

Categories

Tags

Similar tools

Install

npm install MiMo-Code

README

MiMoCode

MiMo Code: Where Models and Agents Co-Evolve

中文 | English

Website | Blog


MiMoCode is a terminal-native AI coding assistant. It can read and write code, run commands, manage Git, and use a persistent memory system to keep a deep understanding of your project across sessions while continuously improving itself.

MiMo Auto is built in as a free-for-limited-time channel, so you can start with zero configuration. MiMoCode also supports connecting to any mainstream LLM provider API.


Quick Start

# One-line install (macOS / Linux)
curl -fsSL https://mimo.xiaomi.com/install | bash

# One-line install (Windows PowerShell)
powershell -ep Bypass -c "irm https://mimo.xiaomi.com/install.ps1 | iex"

# Or install via npm (all platforms)
npm install -g @mimo-ai/cli

# Run
mimo

The first launch guides you through configuration automatically. Supported options:

  • MiMo Auto (free for a limited time) — anonymous channel, zero configuration
  • Xiaomi MiMo Platform — OAuth login
  • Import from Claude Code — migrate existing authentication in one step
  • Custom Provider — add any OpenAI-compatible API in the TUI
WSL: clipboard issues

If you encounter garbled text when copying on WSL, install xsel:

sudo apt install xsel
Windows: garbled CJK (Chinese/Japanese/Korean) output in the shell

On Windows with a non-UTF-8 system locale (e.g. zh-CN, whose active code page is 936/GBK), command output containing CJK characters may appear garbled (mojibake). MiMoCode forces UTF-8 output for spawned PowerShell/cmd subprocesses. If you still encounter garbled output in cases this does not yet cover, enable Windows' system-wide UTF-8 support:

Settings → Time & language → Language & region → Administrative language settings → Change system locale → check "Beta: Use Unicode UTF-8 for worldwide language support" → reboot.

This switches the active code page (ACP) to UTF-8 (65001) for all programs, so subprocesses no longer inherit the legacy code page. Note it is a system-wide Beta toggle and may cause some older non-Unicode programs to display incorrectly, so treat it as a workaround.


MiMo Ecosystem

Beyond MiMoCode, Xiaomi MiMo models also work in other agents and coding tools like Cursor, Cline, and Zed.

awesome-mimo-agent collects setup guides for using MiMo in those tools — worth a look if you want to try MiMo elsewhere. Contributions welcome: open a PR to add your own setup.


Core Features

Multiple Agents

AgentDescription
buildDefault. Full tool permissions for development
planRead-only analysis mode for code exploration and solution design
composeOrchestration mode for specs-driven development and skill-driven workflows

Press Tab to switch between primary agents. Subagents are created by the system as needed.

Persistent Memory

Cross-session memory powered by SQLite FTS5 full-text search:

  • Project memory (MEMORY.md) — persistent project knowledge, rules, and architecture decisions
  • Session checkpoint (checkpoint.md) — structured state snapshots maintained automatically by the checkpoint-writer subagent
  • Scratch notes (notes.md) — temporary note area for agents
  • Task progress (tasks/<id>/progress.md) — per-task logs

Memory is injected automatically when a session resumes, so the agent does not need to relearn project context.

Intelligent Context Manag