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.

Current mtty workspace with a session sidebar, Markdown editor, rendered Mermaid preview and split terminal.
Editor, Mermaid preview and terminal · one example workspace
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.

Package details and first-run steps →

01 three parts

Terminal, editor, agents.

02 the workspace

Beyond the prompt.

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 MB

06 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.

hostmtty-widgetwinit + wgpu render loop; composites egui chrome in the same frame
rendermtty-renderwgpu + glyphon glyph grid; quad and image pipelines
coremtty-corePTY, VT parsing, grid and scrollback, selection, search, OSC, input encoding
alongsidemtty-graphicsmtty-configmtty-mtpmtty-ui

08 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