MiMo-Code AGENTS.md

Repository instructions for XiaomiMiMo/MiMo-Code, describing its coding conventions, development priorities, installation command, and JavaScript software development kit build process.

In plain words
What is it for?
Developing the terminal interface, working on the engine core, regenerating the JavaScript SDK, installing locked dependencies, and following the project’s style and branch conventions.
Why use it?
They help an AI coding assistant follow the project’s rules and focus changes on the maintained terminal interface and the engine behind it.

Instructions file for CodexOpenCode

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/xiaomimimo/mimo-code/agents-md
Clone the repo
git clone --depth 1 https://github.com/XiaomiMiMo/MiMo-Code

Made for: Codex, OpenCode.

Per session 1,169 This file is loaded in full into every session.
When invoked 1,169 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.01169 $0.01169
Opus 5 $0.00584 $0.00584
Sonnet 5 $0.00234 $0.00234
Haiku 4.5 $0.00117 $0.00117

Measured 2d ago against content hash bbf57c5276e3, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

MiMo-Code AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

AGENTS.md · 139 lines

How it starts

The opening of the file, as written. The whole thing — 139 lines — stays where its author put it; the contents beside it link to each section on GitHub.

MiMo-Code

Conventions

  • Use MiMoCode Compose skills when available, otherwise use superpowers skill if installed.
  • To regenerate the JavaScript SDK, run ./packages/sdk/js/script/build.ts.
  • ALWAYS USE PARALLEL TOOLS WHEN APPLICABLE.
  • The default branch in this repo is main.
  • CI triggers on main.
  • Prefer automation: execute requested actions without confirmation unless blocked by missing info or safety/irreversibility.
  • Install deps with bun ci (= bun install --frozen-lockfile) — install per bun.lock, don't mutate the lockfile. ⛔ Do NOT use bun install/npm install.

Core Focus

Development focuses on the TUI (packages/opencode/src/cli/cmd/tui/) and the engine core it runs on. The Web, App and Desktop surfaces are not currently maintained. In practice this means an operation should default to checking the TUI path first.

Style Guide

General Principles

  • Keep things in one function unless composable or reusable
  • Avoid try/catch where possible
  • Avoid using the any type
  • Use Bun APIs where the runtime is Bun-only, like Bun.file() in the TUI (src/cli/cmd/tui/); build-time macros are fine anywhere, as they never reach the shipped runtime
  • In core code reachable from src/node.ts, prefer the Node equivalent when one exists — createHash over Bun.CryptoHasher, prepare() over bun:sqlite's query() — as that code also ships through script/build-node.ts and must run on plain Node
  • Bun-only calls in core escape both typecheck and bun test, which run on Bun; existing usage needs no urgent removal, and APIs with no Node equivalent may stay until a runtime seam exists
  • Rely on type inference when possible; avoid explicit type annotations or interfaces unless necessary for exports or clarity
  • Prefer functional array methods (flatMap, filter, map) over for loops; use type guards on filter to maintain type inference downstream
  • In src/config, follow the existing self-export pattern at the top of the file (for example export * as ConfigAgent from "./agent") when adding a new config module.

Read the full file on GitHub · 139 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 139 lines · 1,169 tokens per session scan A bbf57c5276e3

Subscribe to this mod's changes

MiMo-Code AGENTS.md is an instructions file published in the GitHub repository XiaomiMiMo/MiMo-Code (12,904 stars, last pushed 2d ago), licensed MIT. It adds 1,169 tokens to every session, about $0.0058 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.