Sandbox
@l0ng-ai/tty7

Terminal workbench for persistent shells and agent sessions

tty7 combines a GPU-rendered terminal, a persistent server, SSH, and agent-aware session handling. You get tabs, splits, shell integration, git tools, and session resume without relying on tmux.

859 stars66 forksRustUpdated 7d ago
Who it's for

Builders who want one terminal setup for local shells, remote workspaces, and coding agents.

What it delivers

You can keep agent sessions, shells, and remote panes running after closing the window or rebooting.

What it does

Persistent sessions

A background server owns shells and panes, so sessions keep running when the GUI closes or the machine restarts.

Agent awareness

It detects many coding agents, shows status, notifications, branch and diff context, and can resume sessions after reboot.

CLI and skill bundle

The bundled `tty7` CLI can run, split, send, wait, and capture terminal work, and the repo includes a `skills/tty7/SKILL.md` skill.

Editor-grade input

It adds history-based suggestions, tab completion, syntax highlighting, multi-line editing, caret clicks, and fuzzy history search.

Remote workspaces and SSH

It keeps files, repos, panes, and git data on the remote machine with native SSH, SFTP, port forwarding, and jump hosts.

Git panel

It shows diffs, branch state, worktrees, commit actions, and a commit graph beside the terminal.

How to get it

  1. 1Install the skill with
    npx skills add l0ng-ai/tty7    # install
    npx skills update tty7         # update later

README

tty7

tty7

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

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


CI Version Platforms License Discord

English · 简体中文


tty7 with a tab sidebar of agent sessions across several repos, running Claude Code

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
  • Git beside the terminal — source control, diffs, and worktrees without leaving the window

Install

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

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

What's inside

Agent-awareper-pane detection (20 CLIs) · status dot · notifications · branch + diff · tray icon when input is needed · resume after reboot · tab sidebar grouped by repository
CLI + Skillsbundled tty7 CLI · agent skill · run streams a command and exits with its code · split · send · wait --until free · capture
Editor-grade inputghost suggestions from history · explained tab completion · syntax highlighting · multi-line editing · click places the caret · ⌃ R fuzzy history
Windowtabs & splits · ⌘ P palette · ⌘ F scrollback search · ⌘ J panel with process tree and listening ports · 13 themes, your own YAML, iTerm2 import · IME
Shell integrationinjected when a pane starts, nothing to install · prompt marks · working directory · exit codes · command-finished notifications · zsh, bash, fish, PowerShell, WSL, remote panes
Remote workspacesremote files, repos, changes, diffs, worktrees, tabs, and panes · reconnect from any client and continue where you left off
SSHnative russh stack: profiles with keychain secrets · SFTP panel · port forwarding · jump hosts · one-time, unprivileged tty7-server install
Gitpanel follows the focused pane · stage, commit, amend, branch, push, stash · side-by-side or unified diffs · commit graph with cherry-pick, revert, and reset · a new worktree opens its own tab

Supported agents

Detection is free: brand avatar, branch + diff, tab title. Status takes one click under Settings → Agents 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
AgentDetectedStatus · resumeFork
Claude Code
Codex
TraeCode
Grok
OpenCode
Oh My Pi
Droid
Qwen Code
Goose
Gemini
Copilot
Kimi Code
Pi
Aider
Amp
Cursor
Auggie
Hermes
Vibe
Antigravity

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.

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):

tty7AlacrittyGhosttyKitty
Plaintext I/O — 11 MB cat (lower = better)95 ms239 ms179 ms185 ms
DOOM-fire frame rate (higher = better)888 fps485 fps552 fps617 fps
Cold-launch memory116 MB¹105 MB128 MB130 MB

¹ GUI 105 MB + the persistent server 11 MB.

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


Files in the repo

Repository payload17 top-level entries
  • .cargo
  • .github
  • assets
  • crates
  • docs
  • scripts
  • skills
  • src
  • .gitattributes
  • .gitignore
  • build.rs
  • Cargo.lock
  • Cargo.toml
  • CHANGELOG.md
  • LICENSE
  • README.md
  • README.zh-CN.md

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More tools

JuliusBrussee/
caveman

🪨 why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman

105k
1 add
MemPalace/
mempalace

The best-benchmarked open-source AI memory system. And it's free.

59k
stablyai/
orca

Orca is the ADE for working with a fleet of parallel agents. Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.

66k

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io

132k

Never stop coding. Free MIT AI gateway: one endpoint, 352 providers (150+ free), 1200+ models Kimi, Claude, GPT, Gemini, GLM, DeepSeek, MiniMax. Works with Claude Code, Codex, Cursor, OpenCode, Cline & Copilot. Quota-aware auto-fallback, RTK+Caveman compression saves 15-95% tokens, MCP/A2A, Desktop/PWA. Built by 550+ contributors

64k
headroomlabs-ai/
headroom

Compress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.

71k