From d8ac3ef4541ea92ae6682307a6afce38af6ec59f Mon Sep 17 00:00:00 2001 From: l0ng-ai <24760907+l0ng-ai@users.noreply.github.com> Date: Thu, 20 Aug 2026 21:49:31 +0800 Subject: [PATCH] docs(readme): fix the fork column and restate the feature tables MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The support matrix left Fork blank for Droid, Qwen, and Goose, but all three have a fork command in CLIAgent::fork_label and hooks in HookAgent::ALL, so the menu entry is reachable. Amp stays blank: it has a fork command but no hooks, so no session id ever arrives and can_fork never turns true — which the intro paragraph now states. Also restores "click places the caret" and IME to the input and window rows, folds the prose that had crept into the Agent-aware, CLI, and Git cells back into scannable fragments, and drops the Why lede's repetition of the three bullets directly beneath it. --- README.md | 62 +++++++++++++++++++++++++++---- README.zh-CN.md | 99 ++++++++++++++++++++++++++++++++++--------------- 2 files changed, 124 insertions(+), 37 deletions(-) diff --git a/README.md b/README.md index 0ed27f98..a4c6c7c8 100644 --- a/README.md +++ b/README.md @@ -26,13 +26,16 @@ ## 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 -- **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 +- **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 @@ -48,12 +51,55 @@ Native builds for macOS, Windows, and Linux on [**Releases**](https://github.com | | | |---|---| +| **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 · ⌃ R fuzzy history | -| **Window** | tabs & splits · ⌘ P palette · ⌘ F scrollback search · nine themes · IME | -| **Agent-aware** | per-pane detection (19 CLIs): status dot · notifications · branch + diff · resume after reboot · tray icon when input is needed | +| **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 | -| **CLI + Skills** | bundled `tty7` CLI · [agent skill](skills/tty7/SKILL.md) · 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 | +| **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/`**](docs/) — [keyboard shortcuts](docs/reference/keyboard-shortcuts.mdx) · diff --git a/README.zh-CN.md b/README.zh-CN.md index 46fb6354..014ba97a 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -4,7 +4,7 @@ ### tty7 -**终端工作台：常驻会话、远程工作、agent。** +**终端工作台：会话常驻、远程开发、原生支持 agent。** 纯 Rust · GPU 渲染基于 Zed 的 gpui · VT 内核来自 Alacritty @@ -14,7 +14,7 @@ [![Version](https://img.shields.io/github/v/release/l0ng-ai/tty7?label=version&color=3FDD8C)](https://github.com/l0ng-ai/tty7/releases) [![Platforms](https://img.shields.io/badge/platforms-macOS%20%C2%B7%20Windows%20%C2%B7%20Linux-blue)](https://github.com/l0ng-ai/tty7/releases) [![License](https://img.shields.io/badge/license-Apache--2.0-blue)](LICENSE) -[![Discord](https://img.shields.io/badge/Discord-%E5%8A%A0%E5%85%A5%E7%BE%A4%E7%BB%84-5865F2?logo=discord&logoColor=white)](https://discord.gg/s3dethqz2V) +[![Discord](https://img.shields.io/badge/Discord-%E5%8A%A0%E5%85%A5%E8%AE%A8%E8%AE%BA-5865F2?logo=discord&logoColor=white)](https://discord.gg/s3dethqz2V) [English](README.md) · 简体中文 @@ -26,69 +26,110 @@ ## 为什么 -- **性能** —— 吞吐约为 Alacritty、Ghostty、Kitty 的 2 倍（[基准测试](#基准测试)） -- **持久会话** —— 退出应用、重启机器后，shell 和已支持的 agent 会话照样运行；无需 tmux -- **编辑器级输入** —— 建议、补全、语法高亮、历史搜索 -- **远程开发** —— 文件、仓库、pane 和 git 信息都留在远端机器上 -- **原生 SSH** —— profile、SFTP、端口转发和跳板机 -- **Agent-aware** —— Claude Code、Codex 等：状态、通知、git 上下文 -- **CLI + Skills** —— agent 创建 pane、运行命令、读取输出 +真正持有 shell 和 pane 的是后台常驻的 server，不是窗口。下面这些几乎都是这一个决定的结果。 + +- **性能**：吞吐是 Alacritty、Ghostty、Kitty 的两倍左右（[基准测试](#基准测试)） +- **会话常驻**：退出应用或重启机器后，shell 和已支持的 agent 会话继续运行，不需要 tmux +- **Agent 感知**：Claude Code、Codex 等 agent 的状态、通知和 git 上下文，多个仓库一屏看完 +- **可被 agent 驱动**：一个 agent 能给另一个开 pane、派活、等它跑完、读走结果，GUI 开不开都行 +- **编辑器级输入**：建议、补全、高亮、历史搜索，不用装任何插件 +- **远程开发**：文件、仓库、pane 和 git 信息都留在远端机器上，走自带的 SSH 栈 +- **Git 就在终端旁边**：源代码管理、diff、worktree，不用切出窗口 ## 安装 -三平台原生构建都在 [**Releases**](https://github.com/l0ng-ai/tty7/releases)： +macOS、Windows、Linux 的原生构建都在 [**Releases**](https://github.com/l0ng-ai/tty7/releases)： | | | | |---|---|---| | **macOS** | `…-macos-arm64.dmg` · `…-x86_64.dmg` | 拖进「应用程序」 | -| **Windows** | `…-setup.exe` · 便携版 `….zip` | | -| **Linux** | `…-x86_64.AppImage` | `chmod +x` 直接运行，X11/Wayland 依赖已打包 | +| **Windows** | `…-setup.exe` · 免安装 `….zip` | | +| **Linux** | `…-x86_64.AppImage` | `chmod +x` 后直接运行，X11/Wayland 的库已打包在内 | ## 有什么 | | | |---|---| -| **编辑器级输入** | 历史影子建议 · 带说明的 Tab 补全 · 语法高亮 · 多行编辑 · 点击定位光标 · ⌃ R 模糊历史搜索 | -| **窗口** | 标签页与分屏 · ⌘ P 命令面板 · ⌘ F 回滚搜索 · 9 套主题 · 输入法 | -| **Agent-aware** | 按 pane 识别 19 个 CLI agent：状态点 · 通知 · 分支 + diff · 重启后续上会话 · 托盘图标提醒需要输入 | -| **远程工作区** | 远端文件、仓库、Changes、diff、worktree、标签页和 pane · 任意客户端重连后原地继续 | -| **CLI + Skills** | 安装包自带 `tty7` CLI · [agent skill](skills/tty7/SKILL.md) · pane/工作区控制 · 真实 PTY 命令 · 输出、进程、端口和 agent 状态 | -| **SSH** | 原生 russh 栈：profile 凭据进 keychain · SFTP 面板 · 端口转发 · 跳板机 · 一次无 sudo 安装 `tty7-server` | +| **Agent 感知** | 逐 pane 识别 19 个 CLI agent · 状态点 · 通知 · 分支 + diff · 需要输入时托盘图标提醒 · 重启后续上会话 · 侧边栏按仓库分组 | +| **CLI + Skills** | 安装包自带 `tty7` CLI · [agent skill](skills/tty7/SKILL.md) · `run` 转发命令输出并原样返回退出码 · `split` · `send` · `wait --until free` · `capture` | +| **编辑器级输入** | 从历史推出影子建议 · Tab 补全附带说明 · 语法高亮 · 多行编辑 · 点击定位光标 · ⌃ R 模糊搜索历史 | +| **窗口** | 标签页与分屏 · ⌘ P 命令面板 · ⌘ F 回滚搜索 · ⌘ J 侧栏列出进程树和监听端口 · 13 套主题，也能写自己的 YAML 或导入 iTerm2 配色 · 输入法 | +| **Shell 集成** | pane 启动时自动注入，不用你装什么 · 提示符边界 · 工作目录 · 退出码 · 命令跑完发通知 · 覆盖 zsh、bash、fish、PowerShell、WSL 和远程 pane | +| **远程工作区** | 远端的文件、仓库、改动、diff、worktree、标签页和 pane · 从任意客户端重连，接着离开时的位置继续 | +| **SSH** | 自带 russh 实现，不依赖外部 ssh：profile 凭据存入 keychain · SFTP 面板 · 端口转发 · 跳板机 · `tty7-server` 只需安装一次，无需 root | +| **Git** | 源代码管理面板跟着焦点 pane 走 · 暂存、提交、amend、切分支、push、stash · 双栏或统一 diff · 提交图谱支持 cherry-pick、revert、reset · 新建 worktree 连同它的标签页 | -完整文档在 [**`docs/`**](docs/)（英文）—— +## 支持的 agent + +**识别**无需配置：品牌头像、分支与 diff、标签页标题。 +**状态**需要在设置 → Agents 中为该 agent 安装 hook，一次点击，之后才有状态点、通知、托盘提醒、`tty7 wait` 和重启后恢复会话。 +**Fork** 两个条件都要：agent 自己提供 fork 命令，且 hook 已装——tty7 得知道 fork 的是哪个会话。 + +
+19 个 agent 的完整支持矩阵 + +| Agent | 识别 | 状态 · 重启恢复 | 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 | ✓ | | | + +
+ +tty7 不包装、不代理其中任何一个 —— 你启动的就是那个 agent 本身，运行在普通 PTY 中，界面仍然是它自己的。 +如果你通过 wrapper 脚本启动 agent，在 `config.json` 的 `agent_commands` 里把脚本名映射到对应 agent 即可。 + +## 文档 + +完整文档在 [**`docs/`**](docs/)，英文： [快捷键](docs/reference/keyboard-shortcuts.mdx) · [config.json](docs/reference/configuration.mdx) · -[CLI 参考](docs/cli/reference.mdx)。面向 agent 的 CLI 接口另见 -[skills/tty7/SKILL.md](skills/tty7/SKILL.md)。 +[CLI 参考](docs/cli/reference.mdx)。 +agent 如何调用这套 CLI，另见 [skills/tty7/SKILL.md](skills/tty7/SKILL.md)。 -通过以下命令安装 skill： +安装 skill： ```sh npx skills add l0ng-ai/tty7 # 安装 -npx skills update tty7 # 之后更新 +npx skills update tty7 # 后续更新 ``` ## 基准测试 -同一台机器、同一天、统一 155×40 网格 —— Apple M1 Pro，macOS 26.3.1， -取五次运行的平均值（2026-07-04）： +同一台机器、同一天、同样的 155×40 网格：Apple M1 Pro，macOS 26.3.1，每项运行五次取平均（2026-07-04）。 | | **tty7** | Alacritty | Ghostty | Kitty | |---|---:|---:|---:|---:| -| 纯文本 I/O —— 11 MB `cat` （越低越好） | **95 ms** | 239 ms | 179 ms | 185 ms | +| 纯文本 I/O：`cat` 一个 11 MB 文件 （越低越好） | **95 ms** | 239 ms | 179 ms | 185 ms | | [DOOM-fire](https://github.com/const-void/DOOM-fire-zig) 帧率 （越高越好） | **888 fps** | 485 fps | 552 fps | 617 fps | | 冷启动内存 | 116 MB¹ | 105 MB | 128 MB | 130 MB | -¹ GUI 105 MB + 常驻 server 11 MB。 +¹ GUI 占 105 MB，常驻 server 占 11 MB。 -测试方法与一键复现脚本：[`scripts/bench/`](scripts/bench/README.md)。 +测试方法与一条命令复现：[`scripts/bench/`](scripts/bench/README.md)。 ---
-基于 [gpui](https://github.com/zed-industries/zed) 与 [`alacritty_terminal`](https://github.com/zed-industries/alacritty) 构建 · [Apache-2.0](LICENSE) · [Discord](https://discord.gg/s3dethqz2V) · [更新日志](CHANGELOG.md) +基于 [gpui](https://github.com/zed-industries/zed) 和 [`alacritty_terminal`](https://github.com/zed-industries/alacritty) 构建 · [Apache-2.0](LICENSE) · [Discord](https://discord.gg/s3dethqz2V) · [更新日志](CHANGELOG.md)