miao AI 编程代理
模型由你选，工作持续推进，少浪费上下文。
miao 是一个开源 AI 编程代理，让你在终端里完成真实工程任务，也看清任务消耗了多少时间和费用。使用你选择的模型，让代理理解仓库、修改代码、执行命令并验证结果。
miao 把重点放在模型周围的工程能力上：上下文效率、持久化会话、代理协作，以及长任务的执行控制。
macOS / Linux
curl -fsSL https://mtty.dev/miao/install | bashWindows (PowerShell)
irm https://mtty.dev/miao/install.ps1 | iexmacOS 与 Linux · Windows 已有构建 · MIT
01 中途调整，不必重来
它在干活时，你仍然可以补充要求。
新输入会先持久化保存，再调度执行，在下一个安全的模型轮次边界带入会话。当前的工具调用不会被打断，你打字比它思考还快也不会丢。
显式排队的输入会等到当前工作即将空闲时再处理；任何新输入被采纳后，代理的轮次额度都会重置。
- ›
找到这个测试失败的原因，修复它，运行相关检查，并解释代码差异。
- ›
保持公共 API 不变，不引入新的运行时依赖。
steer · 已保存，在下一个轮次边界并入 - ›
然后写一份草稿 PR 描述。
queue · 等会话即将空闲时再处理
02 为什么选择 miao
功夫花在模型周围。
- 01
按任务选择模型
在同一个界面连接多个供应商，随时切换会话模型，也可以为专门的代理设置各自的模型和权限。按推理能力、响应速度或价格做选择，不必围着某一家重建工作流。
- 02
专项工作交给独立上下文
把范围明确的任务委派给子代理，之后还能继续同一个子会话。借助 list_sessions 和 send_message，代理能在权限约束下发现并联系同项目的其他会话。
- 03
看清 token 和费用花在哪里
逐轮用量、估算费用、首 token 延迟和提示缓存遥测。Context Epoch 保持系统上下文基线不变、把变化按时间顺序引入，帮助复用缓存前缀。
- 04
工作记录可以继续
持久化输入与事件记录保存会话：可查看、重新打开、分叉和导出。过大的工具输出在上下文中受到限制，完整内容在可用时保留到临时文件。
费用按配置的模型费率估算，实际扣费以供应商账单为准。保存历史不代表崩溃后自动续跑：未完成的模型执行需要显式恢复。
03 日常工程
平常的一天，它能做什么。
| 你要完成的事 | miao 提供的能力 |
|---|---|
| 理解陌生仓库 | 文件读取、搜索、项目指令、技能、专项子代理 |
| 实现功能并验证 | 文件编辑与补丁、Shell 命令、可选 LSP 诊断和格式化 |
| 比较模型而不换工具 | 会话内模型切换、自定义供应商、按代理配置模型、受支持模型的推理档位 |
| 推进较大的任务 | 待办、中途补充要求、持久化会话、可选自治续跑 |
| 接入自己的工具 | 本地与远程 MCP、自定义命令、技能、插件 |
| 检查并复用工作成果 | 差异查看、会话分叉、历史导出、权限确认 |
| 接入其他应用 | HTTP 服务、浏览器界面、CLI 自动化、工作区内生成的客户端 |
04 界面
代理，跑在你已经用的终端里。
05 长任务，有边界
让它继续推进 —— 在预算之内。
自治续跑需要手动开启。只要还有未完成的待办，它就继续，并受迭代上限和停滞检测保护。会话估算费用达到阈值后，费用预算会停止调度新的模型轮次。
预算不是供应商账单的硬上限，也不会中止已经发出的那一轮。项目级配置放在 .miao/miao.jsonc，全局配置放在 ~/.config/miao/miao.jsonc。
// .miao/miao.jsonc
{
"loop": { "enabled": true, "max_iterations": 25 },
"cost": { "budget_usd": 5 },
"compaction": { "prune": true },
}06 实测
CPU 密集的地方用 Rust。
miao 内置 Rust 加速模块，并与本仓库早先的 TypeScript 实现做对比。同一台机器、release 构建、取中位数。
编辑模糊匹配，12k 行1.9×
补丁 Unicode 规范化，20k 行2.5×
Git status，10 个文件12.3×
这些是组件基准，不代表端到端任务提速，也不是与上游当前版本的比较。原生编辑/补丁属于兼容工具路径；进程内 Git 仍是原型，默认不启用。
07 现状
1.0 之前，哪些能用说清楚。
| 能力 | 可用性 |
|---|---|
| 持久化会话、输入接收、Context Epoch、项目内会话消息 | 已实现 |
| 自治续跑、费用预算、输出裁剪与压缩调优 | 可选开启 |
| Code Mode | 实验性 |
| 原生编辑/补丁与内核沙箱 | 兼容运行时 |
| 生成的客户端与嵌入式宿主 | API 仍在演进 |
08 快速开始
三条命令，开始第一个会话。
$ curl -fsSL https://mtty.dev/miao/install | bash # macOS / Linux
PS> irm https://mtty.dev/miao/install.ps1 | iex # Windows
$ miao providers login # 选择供应商，连接账户或 API Key
$ cd /path/to/project
$ miao # 启动终端界面
# 一次性执行，不进 TUI
$ miao run "Explain this repository's architecture"
$ miao web # 打开浏览器界面
$ miao upgrade # 更新正式版在 TUI 内用 ctrl+p 打开命令面板，用 ctrl+x m 选择模型。miao models 可以列出可用模型。