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 or reboot; your shells and supported agent sessions keep running, 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 (26 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
Customization	13 built-in themes · your own YAML · iTerm2 color import · rebindable shortcuts · English, 简体中文, 日本語 interface
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.

The full support matrix, all twenty-six

Agent	Detected	Status · resume	Fork
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	✓

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