mtty 终端 · 编辑器 · 代理

终端、编辑器与代理。同处一窗。

在 shell 旁编辑文件,代理需输入时可见,工作期间可预备下一条提示。本地运行,不调用模型。

应用以 mtty 的名字发布(v0.0.5 及之前名为 miaotty),源码在 mtty 仓库。

  • macOSApple 芯片 · Intel
  • Linux.deb · AppImage · tar
  • WindowsMSI · zip

预发布。API 未稳定。macOS 为主要平台;Windows 与 Linux 已构建、测试并在真实桌面验证。Apple 公证与 Windows MSI 签名尚未完成。

当前 mtty 工作区:会话侧栏、Markdown 编辑器、Mermaid 渲染预览和分屏终端。
编辑器、Mermaid 预览与终端 · 同一个示例工作区
终端与远程
GPU 渲染的标签与分屏,主机库、SFTP、端口转发与跳板机,走你自己的 OpenSSH。
编辑器
内置查看与编辑器,Markdown 与 Mermaid 实时预览,在 100 MB 文件上设有性能门。
代理工作台
Claude Code、Codex、OpenCode 与 miao 上报四种状态,变成标签徽章、通知与提示队列。

00 快速上手

从下载到第一个工作区。

安装包选择与首次启动步骤 →

01 三个部分

终端、编辑器、代理。

02 工作台

不止提示符。

03 界面

实景。

使用独立示例项目,从 2026-10-04 的开发构建采集:代理徽章、实时预览、行内改动审阅、主机库、分屏和详情面板。代理状态事件与改动提议通过真实控制面驱动;主机地址为示例。

04 代理状态

它知道每个窗格里的代理在做什么。

代理上报 idle、processing、awaiting 或 error 四种状态。mtty 把它变成标签上的徽章、代理需要你时的系统通知、代理工作时的防休眠,以及在窗格空闲后自动发送下一条消息的提示队列。

miao
通过内置集成上报状态,不用任何配置。
其他代理 CLI
mtty 能识别它们,安装状态钩子脚本,并复制好需要你自己添加的配置片段。绝不替你改动代理的配置。
Composer ⌘E
多行提示编辑器,发送到当前窗格。

05 可脚本化

一个其他程序也能驱动的控制面。

MTP 通过仅属主可访问的每用户套接字(Windows 上为命名管道)收发按行分隔的 JSON。每个响应都带状态版本号;客户端可以阻塞等待它变化,或订阅事件流,而不必轮询。

通过 TCP 提供服务必须设置令牌,还可以用能力白名单限制可接受的请求。控制面会在你的 shell 中执行命令,请妥善保管令牌。

$ mtty-cli pane list
$ mtty-cli pane run --pane ID --data "cargo test"
$ mtty-cli events --topic agent.state
$ mtty-cli wait --since 42
$ mtty-cli view ./README.md
$ mtty-cli file read --path /etc/hosts   # ≤ 2 MB

06 键盘

快捷键

⌘T
新标签
⌘D / ⇧⌘D
向右 / 向下分屏
⌘K
命令面板
⇧⌘O
快速打开
⌘F
查找
⇧⌘R
详情面板
⌘E
Composer
⌘⇧T
Quick Terminal
⌘⇧Z
重新打开关闭的标签
⌘,
设置

以上为终端获得焦点时的 macOS 快捷键;Linux/Windows 对应按键及编辑器优先键位见完整快捷键表。 文档 →

07 引擎

引擎与应用分离。

依赖单向:宿主、渲染、内核。内核不含窗口与 GPU 代码,可嵌入其他程序;应用是引擎的首个使用者。

输出队列有界,仅重绘变化区域,分配有实测预算。

hostmtty-widgetwinit + wgpu 渲染循环,在同一帧合成 egui 界面
rendermtty-renderwgpu + glyphon 字形网格,四边形与图像管线
coremtty-corePTY、VT 解析、网格与回滚、选择、搜索、OSC、输入编码
并列模块mtty-graphicsmtty-configmtty-mtpmtty-ui

08 实测

性能由 CI 把关。

指标保留充足余量:数量级退化使构建失败,运行器抖动不会。

VT 解析吞吐

73 MB/s

预算 ≥ 25 MB/s

屏幕快照,30 行

0.012 ms

预算 ≤ 2 ms

每帧行构建

0.12 ms

预算 ≤ 4 ms

命令面板排序,1 万条

2.0 ms

预算 ≤ 100 ms

基线为 M 系列 Mac 上的 release 构建。帧时间与按键到字形的延迟需要真实窗口和 GPU,因此手动测量,不作为 CI 门槛。

试试预览版。

或者自己构建

$ git clone https://github.com/mttydev/mtty.git && cd mtty
$ cargo run --release -p mtty-app