mirror of
https://github.com/l0ng-ai/tty7.git
synced 2026-09-22 08:02:24 +00:00
l0ng-ai
d60949437c
`shell_integration.rs` ships five scripts — zsh, bash, fish, nushell,
PowerShell. Both READMEs listed four of them and stopped before nushell.
The shell-integration reference page has described it all along, down to
why its wrapper works the way it does ("`source` is parse-time in
Nushell, so the path to your config is resolved as the wrapper is written
rather than checked when it runs"). Only the front pages were missing it,
and the front page is where someone choosing a terminal looks — a shipped
integration nobody knows about is a feature that may as well not exist.
Both languages, because the Chinese README carries a translation of the
same table and had drifted the same way.
The guard holds every script in that file to being named in both, and
checks the scripts are non-empty first so the list cannot go stale by
quietly losing one. Checked against the page as it was: it reports
nushell missing from README.md.
141 lines
6.4 KiB
Markdown
141 lines
6.4 KiB
Markdown
<div align="center">
|
||
|
||
<img src="assets/app-icon.svg" alt="tty7" width="88" height="88" />
|
||
|
||
### tty7
|
||
|
||
**A terminal workbench: persistent sessions, remote work, agents.**
|
||
|
||
<sub>Pure Rust · GPU rendering on Zed's gpui · VT core from Alacritty</sub>
|
||
|
||
<br />
|
||
|
||
[](https://github.com/l0ng-ai/tty7/actions/workflows/ci.yml)
|
||
[](https://github.com/l0ng-ai/tty7/releases)
|
||
[](https://github.com/l0ng-ai/tty7/releases)
|
||
[](LICENSE)
|
||
[](https://discord.gg/s3dethqz2V)
|
||
|
||
<sub>English · [简体中文](README.zh-CN.md)</sub>
|
||
|
||
<br />
|
||
|
||
<img src="assets/hero.webp" alt="tty7 with a tab sidebar of agent sessions across several repos, running Claude Code" width="900" />
|
||
|
||
</div>
|
||
|
||
## 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](#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**](https://github.com/l0ng-ai/tty7/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](skills/tty7/SKILL.md) · `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 · <kbd>⌃ R</kbd> fuzzy history |
|
||
| **Window** | tabs & splits · <kbd>⌘ P</kbd> palette · <kbd>⌘ F</kbd> scrollback search · <kbd>⌘ J</kbd> 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, nushell, 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.
|
||
|
||
<details>
|
||
<summary>The full support matrix, all nineteen</summary>
|
||
|
||
| 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 | ✓ | | |
|
||
|
||
</details>
|
||
|
||
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/`**](docs/) —
|
||
[keyboard shortcuts](docs/reference/keyboard-shortcuts.mdx) ·
|
||
[config.json](docs/reference/configuration.mdx) ·
|
||
[CLI reference](docs/cli/reference.mdx). The agent-facing CLI interface is also
|
||
documented in [skills/tty7/SKILL.md](skills/tty7/SKILL.md).
|
||
|
||
Install the skill with:
|
||
|
||
```sh
|
||
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` <sub>(lower = better)</sub> | **95 ms** | 239 ms | 179 ms | 185 ms |
|
||
| [DOOM-fire](https://github.com/const-void/DOOM-fire-zig) frame rate <sub>(higher = better)</sub> | **888 fps** | 485 fps | 552 fps | 617 fps |
|
||
| Cold-launch memory | 116 MB¹ | 105 MB | 128 MB | 130 MB |
|
||
|
||
<sub>¹ GUI 105 MB + the persistent server 11 MB.</sub>
|
||
|
||
Methodology and one-command reproduction: [`scripts/bench/`](scripts/bench/README.md).
|
||
|
||
---
|
||
|
||
<div align="center">
|
||
<sub>
|
||
|
||
Built on [gpui](https://github.com/zed-industries/zed) and [`alacritty_terminal`](https://github.com/zed-industries/alacritty) · [Apache-2.0](LICENSE) · [Discord](https://discord.gg/s3dethqz2V) · [Changelog](CHANGELOG.md)
|
||
|
||
</sub>
|
||
</div>
|