The composer now stands in for the agent's input instead of sitting under it, so the pane has one input rather than two. - For Claude Code, Codex and Gemini the box is laid over the input area it finds on the grid (Claude's ruled prompt block and the status rows under it, Codex's `›` line, Gemini's framed prompt), painted in the grid's background. When the agent puts something else there — a permission prompt, a picker — the area stops reading as an input; after a 250ms grace the box steps aside and the keyboard goes to the TUI, and both come back with the input. Other agents keep the docked layout. - Over the input, Esc is the agent's (it interrupts), Ctrl+C clears the box or reaches the agent when the box is empty, and text typed at the grid lands in the box. - The toolbar: permission mode (read off the status row the box covers, falling back to the hooks' permission_mode; click or Shift+Tab to cycle), model (click opens Claude's picker), Think (Claude's thinking toggle), and a context ring. Labels come only from what the agent reported. - Claude hooks now carry an AgentReadout — permission_mode from the hook payload, the model and context size of the last main-thread reply from the transcript, the context window (1M for a [1m] model or past 200k), and alwaysThinkingEnabled — worked out in the hook so remote panes get it too. - Visual pass against the design: 13.5px text with the design's padding (the input's own padding subtracted), a 40px toolbar of 28px buttons, a dark round send button, image chips with their own glyph.
tty7
The terminal that outlives its window.
Pure Rust · GPU rendering on Zed's gpui · VT core from Alacritty
English · 简体中文
Most terminals tie your shells to a window. Close the window and the shells die with it. So people run tmux inside their terminal to keep them alive, which works, but it means learning a second set of keys and keeping a second config file, just to get around the window.
tty7 takes a simpler approach. The shells belong to a server running in the background, and the window only shows them. Close the window and nothing happens to the shells. Most of what's interesting about tty7 follows from that one decision.
Quitting doesn't kill anything
Quit tty7 and every shell keeps running. Your build doesn't notice.
A reboot is different. The processes are gone, because that's what a reboot does. But each pane comes back with its layout and the last of what was on screen, and supported agents pick up the same conversation where they left off.
You don't need tmux for any of this, and there's nothing to configure.
Agents that run agents
A lot of people now run several coding agents at once, in several repos. Which means spending the day switching between windows to see which one finished and which one is waiting for an answer. That's not work a person should have to do.
tty7 recognizes 26 coding CLIs, including Claude Code, Codex, Gemini, Cursor, and OpenCode, and puts all of them in one sidebar: whether each is working or waiting, a notification when one needs you, and its branch and diff. You can see at a glance which one wants you.
Once an agent's status is something a program can ask about, the one asking doesn't have to be you. It can be another agent. The whole loop is four commands, with no framework, and it works whether or not the GUI is open:
PANE=$(tty7 split --v) # give the worker a pane
tty7 send "$PANE" 'claude "add tests for the parser"' --enter
tty7 wait "$PANE" --until waiting,done --changed --timeout 600 # until it's done or stuck
tty7 capture "$PANE" --plain # read what happened
tty7 doesn't wrap the agents or sit between you and them. The agent you start is the real one, running in an ordinary PTY. Simple things are more likely to keep working.
→ Orchestrating agents · agent skill · full support matrix
Remote is the same thing
A remote workspace is the same server, running on the other machine. The window here just shows it. Tabs, panes, the file tree, git, and diffs all live over there, and no files get synced. Connect from a different laptop and everything is where you left it.
So remote isn't really a separate feature. It's the local case with the server somewhere else.
The SSH client is tty7's own, written in Rust, so it doesn't depend on the
system's ssh. It has profiles with keychain secrets, jump hosts, SFTP, and
automatic port forwarding. The remote tty7-server installs once and doesn't
need root.
Speed
Speed isn't the point of tty7, but it shouldn't be a weakness either, and it
turns out not to be. cat on an 11 MB file takes 95 ms; the next fastest
terminal we measured takes 179. DOOM-fire runs at 888 fps; the next best manages
617. The method and scripts are public, and one command reproduces them.
| tty7 | Alacritty | Ghostty | Kitty | |
|---|---|---|---|---|
Plaintext I/O — 11 MB cat (lower = better) |
95 ms | 239 ms | 179 ms | 185 ms |
| DOOM-fire frame rate (higher = better) | 888 fps | 485 fps | 552 fps | 617 fps |
| Cold-launch memory | 116 MB¹ | 105 MB | 128 MB | 130 MB |
Apple M1 Pro, macOS 26.3.1, 155×40 grid, five-run averages, 2026-07-04. ¹ GUI 105 MB + the persistent server 11 MB.
Methodology and one-command reproduction: scripts/bench/.
Everything else
The rest is details, but details are most of what makes a tool pleasant to use. The prompt has suggestions from your history, tab completion that explains each option, syntax highlighting, and real multi-line editing, and ⌃ R searches your history. ⌘ P searches everything. ⌘ J opens a side panel with processes, ports, files, changes, and GitHub issues and PRs. Shell integration works in zsh, bash, fish, PowerShell, and WSL without installing anything.
→ Full documentation · keyboard shortcuts · config.json · CLI reference
Install
Native builds on Releases:
| macOS | .dmg for Apple silicon or Intel — drag into Applications |
| Windows | -setup.exe, or the portable .zip |
| Linux | .AppImage — chmod +x and run; X11/Wayland libraries bundled |
Give your agents the CLI skill:
npx skills add l0ng-ai/tty7 # install
npx skills update tty7 # update later
Supported agents
Detection is free: brand avatar, branch + diff, tab title.
Status takes one click under Settings → Integrations to install that agent's hook,
and brings the status dot, notifications, the tray icon, tty7 wait, and resume
after a reboot. Fork needs both — the agent's own fork command, and the hook
that tells tty7 which session to fork. Past sessions are read from the agent's
own history files and listed in Search Everywhere, where ⏎ resumes one.
The full support matrix
| Agent | Detected | Status · resume | Fork | Past sessions |
|---|---|---|---|---|
| Claude Code | ✓ | ✓ | ✓ | ✓ |
| Codex | ✓ | ✓ | ✓ | ✓ |
| TraeCode | ✓ | ✓ | ✓ | |
| Grok | ✓ | ✓ | ✓ | |
| OpenCode | ✓ | ✓ | ✓ | ✓ |
| Oh My Pi | ✓ | ✓ | ✓ | ✓ |
| Prime Agent | ✓ | ✓ | ✓ | |
| Droid | ✓ | ✓ | ✓ | ✓ |
| Qwen Code | ✓ | ✓ | ✓ | ✓ |
| Goose | ✓ | ✓ | ✓ | |
| Qoder CLI | ✓ | ✓ | ✓ | ✓ |
| Qoder CN CLI | ✓ | ✓ | ✓ | ✓ |
| CodeBuddy | ✓ | ✓ | ✓ | ✓ |
| Gemini | ✓ | ✓ | ✓ | |
| Copilot | ✓ | ✓ | ✓ | |
| Kimi Code | ✓ | ✓ | ✓ | |
| Pi | ✓ | ✓ | ✓ | |
| Crush | ✓ | ✓ | ||
| Antigravity | ✓ | ✓ | ||
| Cursor | ✓ | ✓ | ✓ | |
| Aider | ✓ | |||
| Amp | ✓ | |||
| Auggie | ✓ | |||
| Hermes | ✓ | |||
| Vibe | ✓ | |||
| Empryo | ✓ |
Built on gpui and alacritty_terminal · Apache-2.0 · Discord · Changelog
