MiMoCode-Atlas

An honesty-verification fork of Xiaomi MiMoCode.

中文 | English

Upstream official MiMoCode (Xiaomi): Website | Blog

---

MiMoCode-Atlas is a fork of Xiaomi MiMoCode. It keeps the terminal-native AI coding assistant foundation: reading and writing code, running commands, managing Git, preserving cross-session memory, and rebuilding context for long work.

This fork's main difference is Atlas: an evidence-based honesty-verification loop. When an agent says work is done, Atlas checks the trajectory and file-change evidence instead of trusting the agent's self-report.

---

Core: Atlas Honesty-Verification Loop

Atlas is built for long coding sessions where "I changed something" is not the same as "the goal is satisfied."

• Independent auditor (/atlas) - starts as a clean, read-only subagent. It reads the trajectory, tool inputs/outputs, diffs, and ledger evidence, then classifies claims as DONE, NOT DONE, UNSUPPORTED, or out of scope.
• Audit ledger - stores the auditor's report in .mimocode/audit-ledger.md, preserving what was checked and what evidence supported the verdict.
• Automatic rework loop - if the audit returns NOT_DONE, the main agent is told to rework; Atlas can re-audit after the rework and stops after a bounded number of attempts.
• Appeal path - the main agent can contest a failed audit with an explicit APPEAL: line. A separate appeal auditor checks whether the cited evidence really supports the claim.
• High-fidelity context snapshots - each main step can capture the injected CLAUDE/AGENTS/MEMORY context version available at that moment, so later audits can verify what the agent actually knew.
• Structured side-effect traces - write, edit, and bash record diffs and changed files in tool metadata, so audits can inspect what changed rather than infer from prose.

The goal is simple: make completion claims auditable.

---

Quick Start

Prepare Your Environment (First Time Only)

Install these two tools first:

1. Git - download and install it from git-scm.com.
2. Bun - the runtime used by this project. Install it from bun.sh. On Windows, run this in PowerShell:

powershell -c "irm bun.sh/install.ps1 | iex"

After installing Git and Bun, close your terminal and open a new one so the commands are available.

Download and Start

Install this fork from source. Do not use the upstream one-line installer or upstream npm global package if you want this fork; those install Xiaomi's official package, not MiMoCode-Atlas.

Important: Use git clone. Do not use GitHub's Download ZIP button. This project contains symlink files, and ZIP extraction, especially on Windows, can break them and prevent startup.

# 1. Clone the source code
git clone https://github.com/wede-wx/MiMo-Code.git

# 2. Enter the project directory
cd MiMo-Code

# 3. Install dependencies. The first run downloads packages and may take a few minutes.
bun install

# 4. Start in development mode from source
bun run dev

After startup, MiMoCode-Atlas opens an interactive terminal UI. The first launch guides you through API configuration. To use /atlas auditing, choose Xiaomi's paid tier; the free tier does not support it.

MiMoCode-Atlas runs from source here, which means it needs Bun and must be started from the project directory. It is not the upstream one-click global npm install.

You can also run the CLI source entry directly:

bun run --cwd packages/opencode --conditions=browser src/index.ts

Optional: Windows mimo Command

For local convenience on Windows, create mimo.cmd or mimo.ps1 in a directory already on PATH, and point it at your local clone.

mimo.cmd example:

@ECHO off
SETLOCAL
SET "MIMOCODE_REPO=C:\path\to\MiMo-Code\packages\opencode"
bun run --cwd "%MIMOCODE_REPO%" --conditions=browser src/index.ts %*
EXIT /b %ERRORLEVEL%

mimo.ps1 example:

$mimocodeRepo = "C:\path\to\MiMo-Code\packages\opencode"
& bun run --cwd $mimocodeRepo --conditions=browser src/index.ts @args
exit $LASTEXITCODE

Replace C:\path\to\MiMo-Code with your own clone path.

---

How to Use Atlas

When to Use It

Use /atlas after you ask the AI to finish a task, especially if the task has multiple steps, requires verification, or is easy to cut corners on. Atlas is a post-work audit. It does not watch everything automatically forever; you call it when you want to verify whether the work was really done.

How to Use It

After the task is done, type /atlas in the conversation. Atlas audits the current session and gives a verdict: done, not done, or not enough evidence.

If the audit says the work is not done, Atlas automatically asks the AI to rework it, then re-audits after the fix. It repeats this until the task passes, up to three attempts. You do not need to do anything else: type /atlas once and wait for the result. You control when the audit starts.

You may also see /atlas-appeal in the command menu. You normally do not need to run it manually. It is an internal review step that can be triggered behind the scenes when a failed audit needs to check the AI's appeal. It is shown so you know the mechanism exists.

How It Works

/atlas starts an independent, read-only auditor. The auditor does not inherit the prior conversation between you and the AI, and it cannot edit files. It reads the real action record from the task: which commands ran, which files changed, what the exit codes were, and what evidence was recorded.

Then it compares what the AI claimed it did with what actually happened in the evidence. It does not rely on the AI's own summary. That is how it can catch cases where the AI says work was done but the record shows otherwise.

Why It Works This Way

Atlas follows the same idea as a real audit: the person who did the work should not be the only one proving the work was good. A separate role that only reads evidence is more reliable than a self-report. That is the core idea of Atlas.

Requirement

/atlas needs Xiaomi's paid API tier. The free MiMo Auto channel does not support it because its anti-abuse checks can block pure instruction-style auditor requests.

---

Inherited Upstream Capabilities

MiMoCode-Atlas inherits the core MiMoCode foundation from Xiaomi's upstream project:

• Terminal-native agent workflow with code editing, command execution, Git operations, and TUI interaction
• Multiple providers, including custom OpenAI-compatible providers
• Persistent project memory and SQLite FTS search
• Long-context checkpointing and reconstruction
• Subagent orchestration and background work
• Compose workflows, built-in skills, /dream, and /distill
• Claude/OpenCode/Codex import paths from upstream 0.1.1
• Voice input through Xiaomi MiMo hosted services for logged-in Xiaomi MiMo users

For the full upstream product overview, see the upstream official MiMoCode website and blog linked above.

---

This Fork's Additions

The Atlas work adds verification and auditability around the inherited agent runtime:

• /atlas command for evidence-based session audits
• /atlas-appeal flow for contested audit results
• Machine-readable verdict lines for deterministic control flow
• Audit report persistence in .mimocode/audit-ledger.md
• Rework orchestration when an audit fails
• Context snapshot indexing for later evidence checks
• Structured file-change metadata for mutating tools
• Guardrails that keep audit agents read-only and instruction-isolated

---

Development

bun install              # Install dependencies
bun run dev              # Run this fork in development mode
bun turbo typecheck      # Type check

Run package-specific tests from package directories, for example:

cd packages/opencode
bun test test/session --timeout 30000

---

Upstream Official Resources (Xiaomi)

These resources belong to Xiaomi's upstream MiMoCode/MiMo platform, not this fork. They are kept here so users can find the original project, hosted services, and community.

• Official MiMoCode website and blog - linked at the top of this README
• MiMo Auto / Xiaomi MiMo Platform - Xiaomi-hosted model access and OAuth login, subject to Xiaomi's own service terms
• Voice input - powered by Xiaomi MiMo ASR for MiMo logged-in users
• Community group chat - upstream Xiaomi community QR codes below

  

---

Relationship to MiMoCode and OpenCode

MiMoCode-Atlas is a fork of XiaomiMiMo/MiMo-Code, which is itself built as a fork of OpenCode.

The upstream MiMoCode layer adds persistent memory, intelligent context management, subagent orchestration, goal-driven autonomous loops, compose workflows, and self-improvement through /dream and /distill.

This fork keeps that foundation and adds the Atlas honesty-verification loop: audit, ledger, automatic rework, appeals, context snapshots, and structured side-effect evidence.

---

License and Fork Notice

This project is a fork of XiaomiMiMo/MiMo-Code and keeps the original MIT license and copyright notices in LICENSE.

Use of MiMoCode and derivatives is also subject to the upstream Use Restrictions.

If you use Xiaomi MiMo-hosted services, including MiMo Auto, Xiaomi MiMo Platform OAuth, MiMo ASR, or other Xiaomi-hosted model services, that use is subject to the Xiaomi MiMo Terms of Service.

Use of the MiMo name, logo, and trademarks is subject to Xiaomi's MiMo trademark policy.