mirror of
https://github.com/l0ng-ai/tty7.git
synced 2026-09-21 16:02:20 +00:00
l0ng-ai
f811df08ce
`a_routed_auth_prompt_carries_the_machine_that_raised_it` has been waved
through as a known flake all day. It is not one. It fails because the
test helper that builds its `NativeSshSpec` never spells the host.
`SshProfile::new` takes a *name*; the address is a separate `host` field,
and every production caller assigns both — `spec_for`, `open_quick_connect`
and `parse_ssh_connect` all follow `SshProfile::new(host)` with
`profile.host = host`. `native_spec` in this module's tests dropped that
line, so the spec it returns addresses nobody and
`ConnectionKey::from_spec` spells it `me@:22` — the same string for every
machine in the module that talks to port 22.
`ORIGINS` is keyed by exactly that string. So
`a_routed_auth_prompt_carries_the_machine_that_raised_it` (build-box) and
`a_pane_and_its_workspace_resolve_to_the_same_machine` (twin-box) were
noting their origin in one shared slot and then reading it back. libtest
runs them on different threads; whichever noted last won, and the other
was handed the other machine's `HostId`. The routed-auth test usually
lost, because it spawns a responder thread and waits on a mailbox before
it reads, while the pane test reads immediately.
The proof is the origin table at the moment of failure, dumped from a
temporary instrumented build:
assertion `left == right` failed:
origins=[("me@:2222", 12106367783589518659),
("me@:22", 6831549409032087863),
("local-stdio:/opt/tty7-server", 11414125097972604568)]
left: HostId(6831549409032087863) # ssh-direct:me@twin-box:22
right: HostId(7267374002226354343) # ssh-direct:me@build-box:22
An empty host in every key, and the routed-auth test reading twin-box's
id out of build-box's slot.
Measured on 893172f5, Windows 11, one binary per configuration:
| configuration | before | after |
| --------------------------------- | ------ | ----- |
| full suite (`tty7-app`) | 6/20 | 0/40 |
| this module only (`a_` filter) | 17/20 | 0/30 |
| the test alone (`--exact`) | 0/20 | 0/20 |
The isolated column is the tell: nothing outside this module was ever
involved, and no amount of rerunning the test by itself could have shown
the defect.
No product path is affected. Only the test helper forgot the field; the
three callers that build a spec for real assign it, and a route in the
app has always addressed the machine it names.
`two_machines_do_not_share_one_route_origin_key` is the guard: it asserts
the key spells the host and that two machines do not collide. Reverting
the one-line fix fails it in 0.00s with `left: "me@:22"`.
tty7
A terminal workbench: persistent sessions, remote work, agents.
Pure Rust · GPU rendering on Zed's gpui · VT core from Alacritty
English · 简体中文
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.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 (19 CLIs) · status dot · notifications · branch + diff · tray icon when input is needed · resume after reboot · tab sidebar grouped by repository |
| 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 palette · ⌘ F scrollback search · ⌘ J panel with process tree and listening ports · 13 themes, your own YAML, iTerm2 import · IME |
| 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 |
| Git | panel 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 nineteen
| Agent | Detected | Status · resume | Fork |
|---|---|---|---|
| Claude Code | ✓ | ✓ | ✓ |
| Codex | ✓ | ✓ | ✓ |
| 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):
| 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