tty7

A terminal workbench: persistent sessions, remote work, agents.

_{Pure Rust · GPU rendering on Zed's gpui · VT core from Alacritty}

_{English · 简体中文}

_{▶ Watch in full quality}

Why

A background server owns your shells and panes — not the window. Everything below follows from that.

• Performance — ~2× the throughput of Alacritty, Ghostty, or Kitty (benchmarks)
• Persistent sessions — quit the app and your shells keep running; after a reboot, layout, screen, and supported agent conversations come back. No tmux
• Agent-aware — Claude Code, Codex & co.: status, notifications, and git context for every repo at once
• Scriptable by agents — one agent opens a pane for another, hands off a task, waits, and reads the result, with or without the GUI running
• Editor-grade input — suggestions, completion, highlighting, history search, with no plugin to install
• Remote development — files, repos, panes, and git data stay on the remote machine, over a native SSH stack

Install

Native builds for macOS, Windows, and Linux on Releases:

macOS	…-macos-arm64.dmg · …-x86_64.dmg	drag into Applications
Windows	…-setup.exe · portable ….zip
Linux	…-x86_64.AppImage	chmod +x and run — X11/Wayland libraries bundled

What's inside

Agent-aware	per-pane detection (28 CLIs) · status dot · notifications · branch + diff · tray icon when input is needed · resume after reboot · reopen any past session from Search Everywhere · one-key launch · tab sidebar grouped by repository, with pinned groups
CLI + Skills	bundled tty7 CLI · agent skill · run streams a command and exits with its code · split · send · wait --until free · capture
Editor-grade input	ghost suggestions from history · explained tab completion · syntax highlighting · multi-line editing · click places the caret · ⌃ R fuzzy history
Window	tabs & splits · ⌘ P Search Everywhere · ⌘ F scrollback search · hibernate a tab to free its memory · IME
Side panel	⌘ J · process tree and listening ports · file tree · changes and diffs · find in files · GitHub issues and pull requests, read-only, signed in through gh
Shell integration	injected when a pane starts, nothing to install · prompt marks · working directory · exit codes · command-finished notifications · zsh, bash, fish, PowerShell, WSL, remote panes
Remote workspaces	remote files, repos, changes, diffs, worktrees, tabs, and panes · reconnect from any client and continue where you left off
SSH	native russh stack: profiles with keychain secrets · SFTP panel · port forwarding · jump hosts · one-time, unprivileged tty7-server install

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, all twenty-eight

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	✓	✓		✓
Empryo	✓	✓
Muse Code	✓	✓
jcode	✓	✓
Aider	✓
Amp	✓
Auggie	✓
Hermes	✓
Vibe	✓

None of them are wrapped or proxied — the agent you start is the agent you get, in a normal PTY, with its own interface. An agent launched through a wrapper script can be mapped to one by name with agent_commands in config.json. Every agent on your PATH is also a row in Search Everywhere (Agent: Claude Code, …) that opens it in a new tab, and the New Tab menu names the ones you have actually run. agent_launch sets the command line it starts with.

Documentation

Full documentation lives in docs/ — keyboard shortcuts · config.json · CLI reference. The agent-facing CLI interface is also documented in skills/tty7/SKILL.md.

Install the skill with:

npx skills add l0ng-ai/tty7    # install
npx skills update tty7         # update later

Benchmarks

Same machine, same day, same 155×40 grid — Apple M1 Pro, macOS 26.3.1, five-run averages (2026-07-04):

	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

_{¹ GUI 105 MB + the persistent server 11 MB.}

Methodology and one-command reproduction: scripts/bench/.

---

Built on gpui and alacritty_terminal · Apache-2.0 · Discord · Changelog