Config Files#

MiMo Code manages providers, models, server, tools, permissions, and other runtime parameters through JSON / JSONC config files. Multiple layers are merged on load, with the managed layer taking the highest precedence.

For load locations, merge rules, and scenario comparisons, see Config Overrides.

#Top-level fields

#Full example

{
  "$schema": "https://mimo.xiaomi.com//config.json",
  "model": "mimo/mimo-v2.5-pro",
  "small_model": "mimo/mimo-v2.5-pro",
  "default_agent": "build",
  "share": "manual",
  "autoupdate": true,

  "provider": {
    "anthropic": {
      "options": { "timeout": 600000, "setCacheKey": true }
    }
  },

  "server": {
    "port": 4096,
    "hostname": "0.0.0.0",
    "mdns": true
  },

  "permission": {
    "*": "ask",
    "bash": "allow",
    "edit": "deny"
  },

  "compaction": { "auto": true, "prune": true, "tail_turns": 2 },
  "watcher": { "ignore": ["node_modules/**", "dist/**"] },

  "mcp": {},
  "plugin": ["mimocode-helicone-session"],
  "instructions": ["CONTRIBUTING.md"],

  "disabled_providers": ["openai", "gemini"]
}

TUI-related options (tui / theme / keybinds) go in ~/.config/mimocode/tui.json, not in this file.

#Field reference

#model /small_model

Set the default models. Format is provider_id/model_id. When small_model is unset, it falls back to the primary model or a cheaper model within the provider. See Models & Providers.

#provider

Each provider can be configured individually through options:

options also passes through additional fields to the underlying SDK. For provider-specific fields (e.g. Bedrock's region / profile / endpoint), see Provider-specific options.

#server

Server settings for mimo serve / mimo web:

See Server.

#permission

Controls whether tool actions run directly, prompt for approval, or are blocked. Can be set globally or per tool:

{ "permission": { "*": "ask", "bash": "allow", "edit": "deny" } }

For the full rules, see Permissions.

#compaction

Automatic context compaction policy:

#watcher

{ "watcher": { "ignore": ["node_modules/**", "dist/**"] } }

#agent /default_agent

agent defines dedicated agents:

{
  "agent": {
    "code-reviewer": {
      "description": "Reviews code for best practices",
      "model": "mimo/mimo-v2.5-pro",
      "prompt": "You are a code reviewer.",
      "tools": { "write": false, "edit": false }
    }
  },
  "default_agent": "build"
}

default_agent must be a primary agent. An invalid value falls back to "build" with a warning, applied across all interfaces (TUI / mimo run / desktop / GitHub Action). Agents can also be defined with Markdown files; see Agents.

#command

Command templates for repetitive tasks. See Custom Commands:

{
  "command": {
    "test": {
      "template": "Run the full test suite with coverage report.",
      "description": "Run tests with coverage",
      "agent": "build"
    }
  }
}

#share

#autoupdate

Auto-update is enabled when unset. This option has no effect when installed via a package manager (e.g. Homebrew).

#formatter

{
  "formatter": {
    "prettier": { "disabled": true },
    "custom-prettier": {
      "command": ["npx", "prettier", "--write", "$FILE"],
      "environment": { "NODE_ENV": "development" },
      "extensions": [".js", ".ts", ".jsx", ".tsx"]
    }
  }
}

See Formatters.

#plugin

Accepts npm package names or local paths:

{ "plugin": ["mimocode-helicone-session", "./plugins/local.ts"] }

See Plugins.

#skills

{ "skills": { "paths": ["./skills/"], "urls": ["https://example.com/bundle.json"] } }

See Skills.

#tool

Controls tool invocation style:

tool is a different field from the deprecated tools. tools has been merged into permission.

#instructions

Inject additional instruction files; accepts paths and globs:

{ "instructions": ["CONTRIBUTING.md", ".cursor/rules/*.md"] }

See Rules.

#disabled_providers /enabled_providers

{
  "disabled_providers": ["openai", "gemini"],
  "enabled_providers": ["anthropic", "openai"]
}

• A disabled provider won't load even if its environment variable is set or a key is configured via /connect, and its models won't appear in the selection list.
• When enabled_providers is set, only providers in the list are enabled; all others are ignored.
• disabled_providers takes precedence over enabled_providers.

#Other fields

• mcp — MCP servers, see MCP
• lsp — LSP integration, see LSP
• enterprise — { "url": "https://enterprise.example.com" }
• checkpoint — checkpoint thresholds and quotas (thresholds / reserved / push_caps); refer to the schema
• experimental — experimental features that may change or be removed without notice

#Variable substitution

Config values can reference environment variables and file contents:

{
  "model": "{env:MIMOCODE_MODEL}",
  "provider": {
    "anthropic": {
      "options": {
        "apiKey": "{env:ANTHROPIC_API_KEY}",
        "baseURL": "{file:~/.secrets/anthropic-endpoint}"
      }
    }
  }
}

• {env:VAR} — replaced with an empty string when unset
• {file:path} — relative to the config file directory, or an absolute path starting with / or ~

#Schema

Config files follow code.xiaomimimo.com/config.json. Add "$schema" at the top of the file to enable editor completion and validation:

{ "$schema": "https://mimo.xiaomi.com//config.json" }