mtty 终端 · 编辑器 · 代理
终端、编辑器与代理。同处一窗。
在 shell 旁编辑文件,代理需输入时可见,工作期间可预备下一条提示。本地运行,不调用模型。
应用以 mtty 的名字发布(v0.0.5 及之前名为 miaotty),源码在 mtty 仓库。
- macOSApple 芯片 · Intel
- Linux.deb · AppImage · tar
- WindowsMSI · zip
预发布。API 未稳定。macOS 为主要平台;Windows 与 Linux 已构建、测试并在真实桌面验证。Apple 公证与 Windows MSI 签名尚未完成。

- 终端与远程
- GPU 渲染的标签与分屏,主机库、SFTP、端口转发与跳板机,走你自己的 OpenSSH。
- 编辑器
- 内置查看与编辑器,Markdown 与 Mermaid 实时预览,在 100 MB 文件上设有性能门。
- 代理工作台
- Claude Code、Codex、OpenCode 与 miao 上报四种状态,变成标签徽章、通知与提示队列。
00 快速上手
从下载到第一个工作区。
1. 选择安装包
macOS 按 Apple 芯片或 Intel 选 zip;Linux 选 .deb、AppImage 或 tar;Windows 选 MSI 或 zip。
2. 打开 mtty
使用本地终端或连接已保存的 SSH 主机。在命令面板打开文件,与 shell 并排。
3. 运行代理
在窗格里启动已安装的代理 CLI。miao 自动上报状态;其他受支持代理提供 hook 设置入口。
01 三个部分
终端、编辑器、代理。
终端与远程
管理 shell 与主机GPU 渲染的标签与分屏、会话恢复、主机库、SSH 密钥、SFTP 与 FTP、端口转发、跳板机、片段与广播输入。串口、Telnet、原始 TCP 和加密 .ppk 导入也已可用。
编辑器
代码就在终端旁原生编辑器窗格提供语法高亮、多光标、查找替换、大文件查看模式、Markdown 与 Mermaid 预览、语言服务器,以及可选 vim、折叠与大纲。
代理工作台
看状态、补要求、审改动状态徽章、通知与后续提示队列。可审阅可撤销的行内编辑提案,使用 ACP 代理,发送选区或诊断作为上下文,也能用 mtty-cli 自动化操作。
02 工作台
不止提示符。
标签与分屏
⌘D ⇧⌘D递归分屏树,分隔条可拖动。标签可以加标记、分组,重启后依然保留。
快速打开
⇧⌘O一个面板覆盖标签、代理、命令片段、主机、当前目录的文件、最近文件和命令。
详情面板
⇧⌘R信息、代理、大纲、Git、文件、端口、队列,就在终端旁边。
阅读器与编辑器
打开文件原生窗格提供高亮与 LSP、多光标、可选 vim 和实时 Markdown 预览;「在标签中编辑」用于运行外部编辑器。
内联图像
默认开启Sixel、Kitty、iTerm2 图像直接画进网格,随内容滚动、按窗格裁剪。
真正的终端行为
⌘F基于 alacritty_terminal 的 VT、CJK 排版与系统字体回退、带高亮的查找、kitty 键盘协议。
沿用你的配置
config.toml首次运行自动导入 ghostty 和 alacritty 的设置。zsh 集成经由 ZDOTDIR 垫片完成,绝不修改你的 dotfiles。
通过 ssh 编辑远程文件
ssh借助窗格的 ssh ControlMaster 连接查看和编辑远程文件,不用远端辅助程序。
代理状态,一眼可见
hook代理 CLI 上报 idle、processing、awaiting、error 四种状态,并体现在标签徽章、Agent 面板、通知与提示队列上。
窗格自己的任务清单
⇧⌘R大纲面板保留本窗格执行过的命令及其目录,一次会话做过的事就在旁边一目了然。
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 MB06 键盘
快捷键
- ⌘T
- 新标签
- ⌘D / ⇧⌘D
- 向右 / 向下分屏
- ⌘K
- 命令面板
- ⇧⌘O
- 快速打开
- ⌘F
- 查找
- ⇧⌘R
- 详情面板
- ⌘E
- Composer
- ⌘⇧T
- Quick Terminal
- ⌘⇧Z
- 重新打开关闭的标签
- ⌘,
- 设置
以上为终端获得焦点时的 macOS 快捷键;Linux/Windows 对应按键及编辑器优先键位见完整快捷键表。 文档 →
07 引擎
引擎与应用分离。
依赖单向:宿主、渲染、内核。内核不含窗口与 GPU 代码,可嵌入其他程序;应用是引擎的首个使用者。
输出队列有界,仅重绘变化区域,分配有实测预算。
mtty-widgetwinit + wgpu 渲染循环,在同一帧合成 egui 界面mtty-renderwgpu + glyphon 字形网格,四边形与图像管线mtty-corePTY、VT 解析、网格与回滚、选择、搜索、OSC、输入编码mtty-graphicsmtty-configmtty-mtpmtty-ui08 实测
性能由 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