mirror of
https://github.com/l0ng-ai/tty7.git
synced 2026-10-07 16:02:11 +00:00
l0ng-ai
6fcf659e04
* feat(search): replace the command palette with tabbed Search Everywhere The palette was one flat list that every new kind of row had to be squeezed into: tabs and SSH hosts rode along as "Switch to Tab: …" and "SSH: …" commands, and the only way to narrow to one kind was a magic seed word. Search Everywhere splits it into sources behind one trait — All, Actions, Terminals, Hosts — each with its own empty-query layout and ranking. The All tab shows each source's top rows, ordered by best match, with a row that opens the full tab. Tab / Shift-Tab walk the tabs and keep the query. - Terminals lists every open tab of every workspace (reusing the switcher's tab rows) and jumps to it wherever it lives, plus the shells and agents. - Hosts replaces the separate "Add Connection" input: a typed address or full `ssh …` line offers to connect. - Fixes Return doing nothing after a search that found nothing, or when the search opens pre-filtered: gpui-component re-picks the row from a stale frame; the delegate now re-arms the first row. - Fixes `ssh -p 2222 me@box` being offered as a quick-connect address with user `ssh -p 2222 me`. The keymap action stays `TogglePalette` so custom bindings keep working. * feat(search): a Sessions tab to resume past agent sessions Search Everywhere gains a Sessions tab listing the Claude Code and Codex sessions on this computer, read from ~/.claude/projects and ~/.codex/sessions ($CODEX_HOME). Sessions that ran in the focused tab's directory lead; the All tab offers the last three of them before anything is typed. Return opens a new tab in the session's directory and runs the agent's resume command with its configured launch flags. - Only each transcript's head and tail are read, off the window thread, and cached by path, size and mtime: ~170ms cold for 50 sessions, under 1ms warm. The search opens on the cached list and fills in. - Titles: /rename name, then the agent's own title (ai-title, Codex's session_index.jsonl), then the first thing typed, skipping harness injections. Codex rollouts it ran for itself (subagent/internal) and sessions never asked anything are left out. - A session whose directory is gone is refused with a notice rather than resumed where the agent cannot find it.
149 lines
6.7 KiB
Markdown
149 lines
6.7 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 />
|
||
|
||
<a href="assets/tour.mp4"><img src="assets/tour.webp" alt="One-minute tour of tty7: agents across repos, one agent driving another through the CLI, the prompt editor, diffs, dragging panes, and sessions that survive quitting the app" width="900" /></a>
|
||
|
||
<sub>▶ <a href="assets/tour.mp4">Watch in full quality</a></sub>
|
||
|
||
</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
|
||
|
||
## 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 (25 CLIs) · status dot · notifications · branch + diff · tray icon when input is needed · resume after reboot · tab sidebar grouped by repository, with pinned groups |
|
||
| **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> Search Everywhere · <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, 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 |
|
||
|
||
## Supported agents
|
||
|
||
**Detection** is free: brand avatar, branch + diff, tab title.
|
||
**Status** takes one click under Settings → Integrations 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 twenty-five</summary>
|
||
|
||
| Agent | Detected | Status · resume | Fork |
|
||
|---|:-:|:-:|:-:|
|
||
| **Claude Code** | ✓ | ✓ | ✓ |
|
||
| **Codex** | ✓ | ✓ | ✓ |
|
||
| **TraeCode** | ✓ | ✓ | ✓ |
|
||
| **Grok** | ✓ | ✓ | ✓ |
|
||
| **OpenCode** | ✓ | ✓ | ✓ |
|
||
| **Oh My Pi** | ✓ | ✓ | ✓ |
|
||
| **Prime Agent** | ✓ | ✓ | ✓ |
|
||
| **Droid** | ✓ | ✓ | ✓ |
|
||
| **Qwen Code** | ✓ | ✓ | ✓ |
|
||
| **Goose** | ✓ | ✓ | ✓ |
|
||
| **Qoder CLI** | ✓ | ✓ | ✓ |
|
||
| **CodeBuddy** | ✓ | ✓ | ✓ |
|
||
| **Gemini** | ✓ | ✓ | |
|
||
| **Copilot** | ✓ | ✓ | |
|
||
| **Kimi Code** | ✓ | ✓ | |
|
||
| **Pi** | ✓ | ✓ | |
|
||
| **Crush** | ✓ | ✓ | |
|
||
| **Antigravity** | ✓ | ✓ | |
|
||
| **Cursor** | ✓ | ✓ | |
|
||
| Aider | ✓ | | |
|
||
| Amp | ✓ | | |
|
||
| Auggie | ✓ | | |
|
||
| Hermes | ✓ | | |
|
||
| Vibe | ✓ | | |
|
||
| Empryo | ✓ | | |
|
||
|
||
</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`.
|
||
Every agent on your `PATH` is also a row in Search Everywhere (**Agent: Claude Code**, …)
|
||
that opens it in a new tab; `agent_launch` sets the command line it starts with.
|
||
|
||
## 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>
|