mtty Terminal · editor · agents
Terminal, editor, agents:one window.
Edit beside the shell, see when an agent needs input, queue the next prompt while it works. Runs locally; never calls a model.
The application ships as mtty (called miaotty up to v0.0.5); the source lives in mtty.
- macOSApple silicon · Intel
- Linux.deb · AppImage · tar
- WindowsMSI · zip
Pre-release. The API is not stable yet. macOS is the primary platform; Windows and Linux are built, tested and checked on real desktops. Apple notarization and Windows MSI signing are still pending.

- Terminal and remote
- GPU-rendered tabs and splits, a host library, SFTP, port forwarding and jump hosts, over your own OpenSSH.
- Editor
- A built-in viewer and editor with Markdown and Mermaid preview, held to a 100 MB performance gate.
- Agent workspace
- Claude Code, Codex, OpenCode and miao report idle, processing, awaiting or error — a tab badge, a notification and a prompt queue.
00 getting started
From download to your first workspace.
1. Choose a package
macOS: Apple silicon or Intel zip. Linux: .deb, AppImage or tar. Windows: MSI or zip.
2. Open mtty
Use a local terminal or connect a saved SSH host. Open a file beside its shell with Open File… in the command palette.
3. Run your agent
Start an installed agent CLI in a pane. miao reports state automatically; other supported agents have hook setup actions.
01 three parts
Terminal, editor, agents.
Terminal and remote
Your shells and hostsGPU-rendered tabs and splits, session restore, saved hosts, SSH keys, SFTP and FTP, port forwarding, jump hosts, snippets and broadcast input. Serial, Telnet, raw TCP and encrypted .ppk import are available too.
Editor
Code beside its terminalNative editor panes with syntax highlighting, multiple cursors, find and replace, large-file view mode, Markdown and Mermaid preview, language servers, optional vim, folding and outline.
Agent workspace
See, steer and reviewState badges, notifications and follow-up prompt queues. Review undoable inline edit proposals, use ACP agents, send selections or diagnostics as context, and automate with mtty-cli.
02 the workspace
Beyond the prompt.
Tabs and splits
⌘D ⇧⌘DA recursive split tree with draggable dividers. Tabs can be marked and grouped, and both survive a restart.
Open Quickly
⇧⌘OOne palette over tabs, agents, snippets, hosts, files in the current folder, recent files and commands.
Details panel
⇧⌘RInfo, Agent, Outline, Git, Files, Ports and Queue, beside the terminal.
Reader and editor
Open File…Native editor panes with highlighting and LSP, multi-cursor editing, optional vim and live Markdown previews. Edit in Tab runs your external editor.
Inline graphics
on by defaultSixel, Kitty and iTerm2 images drawn in the grid; they scroll with the content and clip to the pane.
Real terminal behaviour
⌘FVT via alacritty_terminal, CJK layout with system font fallback, find with highlighting, the kitty keyboard protocol.
Brings your config
config.tomlImports ghostty and alacritty settings on first run. zsh integration arrives through a ZDOTDIR shim; your dotfiles are never modified.
Remote files over ssh
sshView and edit a remote file through the pane's ssh ControlMaster connection, without a remote helper application.
Agent state, at a glance
hookAgent CLIs report idle, processing, awaiting or error. It becomes a tab badge, the Agent panel, a notification and a prompt queue.
The pane's own task list
⇧⌘RThe Outline panel keeps the commands run in this pane, with their directory, so the work of a session stays visible beside it.
03 the screens
In the real app.
Captures from the 2026-10-04 development build, using an isolated example project: agent badges, live preview, inline edit review, hosts, splits and the details panels. Agent-state events and edit proposals are driven through the real control plane; the host addresses are examples.





04 agent state
It knows what the agent in each pane is doing.
Agents report idle, processing, awaiting or error. mtty turns that into a badge on the tab, a system notification when one needs you, a sleep guard while one is working, and a prompt queue that sends the next message once the pane goes idle.
- miao
- Reports its state from a built-in integration. Nothing to wire up.
- Other agent CLIs
- mtty detects them, installs a state hook script and copies the snippet for you to add. Your agent's config is never edited for you.
- Composer ⌘E
- A multi-line prompt editor that sends to the focused pane.
05 scriptable
A control plane other programs can drive.
MTP speaks newline-delimited JSON over a per-user socket created with owner-only permissions — a named pipe on Windows. Every response carries a state revision; clients can block until it moves, or subscribe to an event stream instead of polling.
Serving it over TCP requires a token, and a capability allowlist can restrict what is accepted. The control plane runs commands in your shell, so treat the token as a secret.
$ 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 keyboard
Shortcuts
- ⌘T
- New tab
- ⌘D / ⇧⌘D
- Split right / down
- ⌘K
- Command palette
- ⇧⌘O
- Open Quickly
- ⌘F
- Find
- ⇧⌘R
- Details panel
- ⌘E
- Composer
- ⌘⇧T
- Quick Terminal
- ⌘⇧Z
- Reopen closed tab
- ⌘,
- Settings
These are macOS shortcuts for terminal focus. Linux/Windows bindings and editor overrides are listed in the shortcut guide. Documentation →
07 the engine
Engine and app, separate.
Dependencies point one way: host, renderer, core. The core has no windowing or GPU code and can be embedded elsewhere; the app is its first user.
Bounded output queues, redraws limited to changed regions, measured allocation budgets.
mtty-widgetwinit + wgpu render loop; composites egui chrome in the same framemtty-renderwgpu + glyphon glyph grid; quad and image pipelinesmtty-corePTY, VT parsing, grid and scrollback, selection, search, OSC, input encodingmtty-graphicsmtty-configmtty-mtpmtty-ui08 measured
Performance, checked by CI.
Metrics keep wide margins: an order-of-magnitude regression fails the build; runner jitter does not.
VT parse throughput
73 MB/s
Budget ≥ 25 MB/s
Screen snapshot, 30 rows
0.012 ms
Budget ≤ 2 ms
Row build per frame
0.12 ms
Budget ≤ 4 ms
Palette rank, 10k entries
2.0 ms
Budget ≤ 100 ms
Baselines are release builds on an M-series Mac. Frame time and key-to-glyph latency need a real window and GPU, so they are measured by hand rather than gated.
Try the preview.
or build it
$ git clone https://github.com/mttydev/mtty.git && cd mtty
$ cargo run --release -p mtty-app