🚀 MiMo Code 使用清单

小米 MiMo 团队出品的终端原生 AI 编程助手 — MIT 开源 已安装版本: v0.1.3 | 安装方式: npm install -g @mimo-ai/cli

---

📦 安装与升级

# npm 安装（已装）
npm install -g @mimo-ai/cli

# 升级到最新版
mimo upgrade

# 卸载
mimo uninstall

---

🎯 启动方式

基础启动

mimo                       # 在当前目录启动 TUI（交互式终端界面）
mimo /path/to/project      # 在指定项目目录启动
mimo run "帮我重构这个函数"  # 直接运行一次性任务（非交互）
mimo run -f src/app.ts "解释这个文件"   # 附带文件运行

高级启动选项

选项	说明
-m, --model <provider/model>	指定模型（如 deepseek/deepseek-chat）
-c, --continue	继续上一次会话
-s, --session <id>	继续指定会话
--fork	从某会话分叉出新会话
--never-ask	自动模式（权限除外），减少交互确认
--trust	跳过工作区信任提示
--agent <name>	指定使用的 agent
--variant <level>	推理强度：high / max / minimal
--thinking	显示模型思考过程

---

🧭 命令大全

主要命令

命令	说明
mimo	启动交互式 TUI（默认）
mimo run <消息>	非交互模式，直接执行任务
mimo serve	启动无头（headless）服务端
mimo attach <url>	连接到运行中的 MiMo 服务
mimo acp	启动 ACP（Agent Client Protocol）服务

模型与提供商

命令	说明
mimo models	列出所有可用模型
mimo models <provider>	查看某提供商的所有模型
mimo models --verbose	查看模型详细信息（含费用）
mimo models --refresh	刷新模型缓存
mimo providers list	列出已配置的 AI 提供商
mimo providers login <url>	登录提供商
mimo providers logout	登出提供商
mimo providers whoami	查看当前登录用户信息

会话管理

命令	说明
mimo session list	列出所有历史会话
mimo session delete <id>	删除指定会话
mimo session import-claude	导入 Claude Code 会话
mimo export <sessionID>	将会话导出为 JSON
mimo import <file/url>	导入会话数据

Agent 管理

命令	说明
mimo agent list	列出所有可用 agent
mimo agent create	创建自定义 agent

GitHub 集成

命令	说明
mimo github install	安装 GitHub Agent
mimo github run	运行 GitHub Agent
mimo pr <number>	拉取并切换到 PR 分支，然后运行 MiMo

其他

命令	说明
mimo stats	查看 token 使用和费用统计
mimo debug	调试和故障排查工具
mimo plugin <module>	安装插件并更新配置
mimo db	数据库工具
mimo completion	生成 shell 自动补全脚本
mimo upgrade	升级到最新版本

---

🔧 运行时命令（TUI 内部）

在 mimo 启动交互式界面后，可以输入这些斜杠命令：

命令	说明
/goal <目标>	设置任务完成条件，内置裁判模型防止过早停止
/dream <主题>	将知识提取到持久记忆（MEMORY.md）中
/distill <技能名>	将重复工作流打包为可重用技能
/never-ask	切换自动模式开关
/help	查看帮助
/exit	退出会话

---

🧠 核心特性速览

1. 持久记忆系统

• 基于 SQLite FTS5 的跨会话记忆
• 自动保存 MEMORY.md、检查点快照、任务进度日志
• Ctrl+C 中断时自动生成检查点，恢复时自动重建上下文

2. 三种 Agent 模式

模式	用途	能力
build（默认）	开发编码	读取、编辑、搜索、执行命令等全工具
plan	规划分析	只读浏览代码库，不修改文件
compose	规范驱动开发	设计 → 计划 → 编码 → 测试 → 审查 完整流水线

3. 智能上下文管理

• 接近 token 上限时自动创建检查点
• 按重要性排序，预算式注入上下文
• 子代理系统支持并行任务处理

4. 多模型支持

• 支持 75+ LLM 提供商（DeepSeek、Kimi、GLM、OpenAI、Anthropic 等）
• 内置免费 MiMo Auto 频道（MiMo-V2.5 模型）
• 通过 -m 参数或 mimo providers login 配置

5. 语音输入

• 实时流式 ASR（自动语音识别）
• 需要安装 sox 命令行音频工具
• 引擎：MiMo-V2.5-ASR

---

🔑 模型配置

配置 AI 提供商

# 查看可用模型
mimo models

# 配置提供商（交互式登录）
mimo providers login

# 启动时指定模型
mimo -m openai/gpt-4o
mimo -m deepseek/deepseek-chat
mimo -m anthropic/claude-sonnet-4-6
mimo run "..." -m kimi/kimi-k2

提供商列表（部分）

• openai — OpenAI 系列
• anthropic — Claude 系列
• deepseek — DeepSeek 系列
• kimi — Kimi（月之暗面）
• glm — GLM（智谱）
• qwen — Qwen（阿里通义）
• doubao — 豆包（字节跳动）
• MiMo Auto 频道 — 内置免费调用 MiMo-V2.5

---

💡 最佳实践

1. 项目启动：在项目根目录运行 mimo，让它先了解项目结构
2. 分阶段任务：用 mimo run -m plan "分析项目架构" 先规划再动手
3. 利用记忆：通过 /dream 将重要发现存入长期记忆
4. 编码规范：编写 /distill 技能来自动化重复性任务
5. 继续会话：用 mimo -c 继续上次未完成的开发任务
6. 协作共享：用 mimo export 导出会话与团队成员分享
7. 批量任务：使用 mimo run 配合 -f 附件文件执行脚本化任务
8. 远程模式：mimo serve + mimo attach 实现远程开发

---

⚙️ 运行选项速查

# 最简启动
mimo

# 指定项目 + 模型
mimo /my-project -m deepseek/deepseek-chat

# 继续上次会话
mimo -c

# 一次性任务（非交互）
mimo run "项目根目录下创建一个 README.md"

# 启动无头服务，供远程连接
mimo serve --port 4096

# 远程连接到服务
mimo attach http://localhost:4096

# 导入 Claude Code 历史会话
mimo session import-claude

---

🐛 故障排查

# 调试模式
mimo debug

# 查看日志
mimo --log-level DEBUG

# 纯净模式（不加载外部插件）
mimo --pure

# 包重新安装
npm install -g @mimo-ai/cli

# 查看版本
mimo --version

📝 注意：MiMo Code 初版为 v0.1.x 阶段，如遇问题请检查 GitHub Issues

---

生成日期：2026-06-27 项目主页：GitHub - XiaomiMiMo/MiMo-Code: MiMo Code: Where Models and Agents Co-Evolve · GitHub