mirror of
https://github.com/l0ng-ai/tty7.git
synced 2026-09-22 08:02:24 +00:00
2c462dd027
Windows hands every process a private copy of the environment block at `CreateProcess` time and never updates it. A tty7 daemon that has been up since before an installer edited `HKCU\Environment` therefore gave a brand-new pane its startup `PATH`, and the freshly installed command was unresolvable until tty7 restarted (#333) — while a Windows Terminal launched from Explorer found it, because Explorer rebuilds its own block when it sees `WM_SETTINGCHANGE`. Rather than chase broadcast messages, `daemon::windows_env` re-reads the two hives Windows itself composes a process environment from — the machine `Session Manager\Environment` and `HKCU\Environment` — at the moment a pane is spawned, and pins the merge onto the pane's command. The merge is a pure function over (machine, user, process, configured overrides), so every semantic that matters is unit-testable without a registry: - Names are keyed case-insensitively, so a `Path` from the process block and a `PATH` from a hive collapse into one variable instead of reaching the child as two. - `PATH` and `PSModulePath` are *combined* — machine value first, user value appended — which is what Windows does and what keeps a per-user install from shadowing the system half. Nothing is ever written back to the user hive; that would bake the machine half into it permanently. - `REG_EXPAND_SZ` values are expanded against the merged map, so a user value naming a machine value naming a process value resolves. A reference that resolves to nothing is left verbatim, as Windows leaves it, and the chain is depth-bounded so a self-referential value cannot hang the spawn path. - The machine hive's `USERNAME=SYSTEM` is dropped, as Windows drops it. - Directories the daemon's own `PATH` held that neither hive lists stay reachable, appended behind the registry entries: freshening `PATH` should only ever add resolvable commands, never take one away. - Configured `env` overrides are applied last and win outright. Non-Windows builds are untouched: only the registry reader and the spawn wiring are `cfg(windows)`, while `cfg(test)` keeps the pure merge compiling everywhere so its tests run on every platform. Co-authored-by: l0ng-ai <24760907+l0ng-ai@users.noreply.github.com> Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
tty7
A terminal workbench: persistent sessions, remote work, agents.
Pure Rust · GPU rendering on Zed's gpui · VT core from Alacritty
English · 简体中文
Why
- 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
- Editor-grade input — suggestions, completion, highlighting, history search
- Remote development — files, repos, panes, and git data stay on the remote machine
- Native SSH — profiles, SFTP, port forwarding, and jump hosts
- Agent-aware — Claude Code, Codex & co.: status, notifications, git context
- CLI + Skills — agents create panes, run commands, and inspect output
Install
Native builds for each platform 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
| 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 · nine themes · IME |
| Agent-aware | per-pane detection (~17 CLIs): status dot · notifications · branch + diff · resume after reboot · tray icon when input is needed |
| Remote workspaces | remote files, repos, changes, diffs, worktrees, tabs, and panes · reconnect from any client and continue where you left off |
| CLI + Skills | bundled tty7 CLI · agent skill · pane/workspace control · real PTY commands · output, process, port, and agent status |
| SSH | native russh stack: profiles with keychain secrets · SFTP panel · port forwarding · jump hosts · one-time, unprivileged tty7-server install |
Terminal and keybinding reference: docs/features.md. The agent-facing CLI interface is documented in skills/tty7/SKILL.md.
Install the skill with:
npx skills add l0ng-ai/tty7
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