mirror of
https://github.com/l0ng-ai/tty7.git
synced 2026-09-21 16:02:20 +00:00
l0ng-ai
52b2742977
A host could be described in full in Settings and still not be connectable from there: there was no password box anywhere on the form. The only way to store a password was to connect, wait to be asked, and tick "remember" — and the only way to correct a wrong one was to connect again and fail first. The key file lived two disclosure triangles deep under Advanced, as a textarea of paths with nothing to pick one. The form now carries the credential half of a connection, in an Authentication block between the address and the collapsed sections: - A password box, masked with a reveal toggle, seeded from the system keychain so a stored password can be read back, corrected or cleared without dialling anything. Clearing it and saving is how a saved password is let go of. - Identity files, moved up out of Advanced, with a Browse button that opens the system picker and writes the path back as `~/.ssh/...` rather than the absolute path the dialog hands over. - A key passphrase box beside it, stored against the contents of the key it unlocks — the same account the connect-time prompt uses. It follows whichever key the field names, and says so when there is no readable key to store one against. Which boxes appear follows the method, the way every other SSH client does it. The split is `build_spec_inner`'s: a password for Auto and Password, key passphrases for Auto and Key, and nothing for Agent, GSSAPI or 2FA — a box outside that would collect a secret, store it in the keychain, and never offer it to anybody. Nothing secret reaches the config file. That is also why Save could not see a typed password: the dirty check compares profiles, and no profile holds one. It now folds the two secrets in, so Save lights up for a password the way it does for a port. Saving moves a password with the address it is filed under — the keychain accounts by endpoint, not by profile — and leaves nothing behind under the old one, unless another host still dials it. A passphrase belongs to its key rather than to this profile, so pointing a host at a different key never touches the first key's entry. Test dials with what is on screen rather than only with what is stored, so it stops reporting a failure the form could not explain. The layout is the other half of the report. These rows were built out of the settings rows the rest of the page uses, which push their control to the far right edge: right for a list of independent switches, wrong for a form, and it left a hand's width of nothing between the word "Host" and the box a hostname goes in. Labels now sit right-aligned against their fields, descriptions and errors moved under the field they are about, and the three that only restated their label became hints inside the box. Two bugs the new shape turned up: a percentage-width control inside a flex-grown wrapper has no definite parent to resolve against, so the host and key fields collapsed to one character and the method dropdown clipped its own menu to "GSSAP"; and "Needs a host" appeared in red on a form nobody had typed in, because the untouched check counted a port field that opens on 22 and is never empty. Claude-Session: https://claude.ai/code/session_01LAqfzqELnoDWU56LBXS1Nh
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 (20 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 twenty
| Agent | Detected | Status · resume | Fork |
|---|---|---|---|
| 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):
| 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