XiaomiMiMo/MiMo-Code

What it is

MiMoCode is a terminal-native AI coding assistant that reads and writes code, runs commands, manages Git, and keeps project understanding across sessions through a persistent memory system. It offers build, plan, and compose agents, subagents, task tracking, deterministic JavaScript workflows, and bundled skills. It also powers the Xiaomi MiMo Desktop app as its core engine and can connect to mainstream LLM provider APIs.

Who it's for

• Developers who want an AI coding agent in the terminal
• Users who need project knowledge preserved across sessions via memory and checkpoints
• Teams wanting spec-driven or automated multi-agent workflows such as compose, deep-research, and fact-check
• Users who want to connect their own OpenAI-compatible or mainstream LLM providers

Requirements

Setup

1. Install and run

   Install with the one-line script (macOS/Linux), PowerShell (Windows), or npm (all platforms), then launch mimo. The first launch guides you through provider configuration.

   bashCopy

   # 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

2. Fix WSL clipboard garbling

   If copying on WSL produces garbled text, install xsel.

   bashCopy

   sudo apt install xsel

3. Use iTerm2 on macOS

   The built-in macOS Terminal is not supported; iTerm2 or the VS Code integrated terminal is recommended.

   bashCopy

   brew install --cask iterm2

Examples

# Remote host
mimo serve --port 4096

# Local host: create the SSH port forward
ssh -N -L 4096:127.0.0.1:4096 user@remote-host

# Local host: connect from another terminal
mimo attach http://127.0.0.1:4096

{
  "compaction": {
    "max_context": {
      "openai/gpt-5.6": "272K", // token count, "300K", "1M", or "50%" of the window
      "anthropic/*": "300K" // wildcards allowed, longest pattern wins
    }
  }
}

{
  "$schema": "https://mimo.xiaomi.com/mimocode/config.json",
  "model": "custom/MODEL_NAME",
  "provider": {
    "custom": {
      "name": "Custom",
      "npm": "@ai-sdk/openai-compatible",
      "only_configured_models": true,
      "models": {
        "MODEL_NAME": {
          "name": "MODEL_NAME"
        }
      },
      "options": {
        "baseURL": "BASE_URL",
        "apiKey": "API_KEY"
      }
    }
  }
}

{
  "json.schemaDownload.trustedDomains": {
    "https://mimo.xiaomi.com/": true
  }
}

Pros & cons