Files
tty7/README.zh-CN.md
l0ng-aiandl0ng-ai 817447bd48 feat(agents): recognize Oh My Pi and install its status hooks (#405)
Issue #376 asked for `omp`. Oh My Pi is a fork of Pi (can1357/oh-my-pi,
descended from badlogic/pi-mono), but the fork is where the similarity
stops for our purposes: it ships one binary of its own — `omp`, the only
`bin` in `@oh-my-pi/pi-coding-agent`, and it never installs a `pi` — and
it keeps its config under `~/.omp`. A pane running it was therefore not
detected at all, and aliasing `omp` onto `CLIAgent::Pi` would have been
worse than nothing: the status bridge would land in `~/.pi`, and Resume
Session would offer `pi --session <id>` to a binary that spells that
flag `--resume`.

So it gets its own variant, wired the whole way through:

| | |
|---|---|
| Detection | argv stem `omp`, distinct from `pi` in both directions |
| Avatar | its own mark, normalized from the project's `assets/icon.svg` |
| Resume | `omp --resume <id>`, opting out on `--no-session` |
| Fork | `omp --fork <id>` — a verified fork command, so the menu item appears |
| Hooks | Settings → Agents, at `~/.omp/agent/extensions/tty7/index.ts` |

The status bridge is the one piece the fork did not change. Oh My Pi
inherited Pi's extension contract intact — same default-exported factory,
same `session_start` / `agent_start` / `agent_end` / `session_shutdown`,
same `ctx.sessionManager.getSessionId()` — so `pi_extension_ts` now takes
the agent and substitutes two things, the package it imports the type
from and the slug it calls the emitter with. Pi's generated file is
byte-identical to before, so no installed bridge goes stale.

`--resume`, `-r` and `--session` are three spellings of one flag in Oh My
Pi; all three shed when a session command is rebuilt, while `--session-dir`
is a different flag and rides along. `fork_command` now honors the same
`--no-session` opt-out `resume_command` already did — Oh My Pi rejects
`--fork` outright under it, and no existing agent declares an opt-out.

Co-authored-by: l0ng-ai <24760907+l0ng-ai@users.noreply.github.com>
2026-08-08 13:10:38 +08:00

3.8 KiB
Raw Permalink Blame History

tty7

tty7

终端工作台:常驻会话、远程工作、agent。

纯 Rust · GPU 渲染基于 Zed 的 gpui · VT 内核来自 Alacritty


CI Version License Discord

English · 简体中文

为什么

  • 性能 —— 吞吐约为 Alacritty、Ghostty、Kitty 的 2 倍(基准测试
  • 持久会话 —— 退出应用、重启机器后,shell 和已支持的 agent 会话照样运行;无需 tmux
  • 编辑器级输入 —— 建议、补全、语法高亮、历史搜索
  • 远程开发 —— 文件、仓库、pane 和 git 信息都留在远端机器上
  • 原生 SSH —— profile、SFTP、端口转发和跳板机
  • Agent-aware —— Claude Code、Codex 等:状态、通知、git 上下文
  • CLI + Skills —— agent 创建 pane、运行命令、读取输出

安装

三平台原生构建都在 Releases

macOS …-macos-arm64.dmg · …-x86_64.dmg 拖进「应用程序」
Windows …-setup.exe · 便携版 ….zip
Linux …-x86_64.AppImage chmod +x 直接运行,X11/Wayland 依赖已打包

有什么

编辑器级输入 历史影子建议 · 带说明的 Tab 补全 · 语法高亮 · 多行编辑 · 点击定位光标 · ⌃ R 模糊历史搜索
窗口 标签页与分屏 · ⌘ P 命令面板 · ⌘ F 回滚搜索 · 9 套主题 · 输入法
Agent-aware 按 pane 识别约 18 个 CLI agent:状态点 · 通知 · 分支 + diff · 重启后续上会话 · 托盘图标提醒需要输入
远程工作区 远端文件、仓库、Changes、diff、worktree、标签页和 pane · 任意客户端重连后原地继续
CLI + Skills 安装包自带 tty7 CLI · agent skill · pane/工作区控制 · 真实 PTY 命令 · 输出、进程、端口和 agent 状态
SSH 原生 russh 栈:profile 凭据进 keychain · SFTP 面板 · 端口转发 · 跳板机 · 一次无 sudo 安装 tty7-server

终端和快捷键参考:docs/features.zh-CN.md。面向 agent 的 CLI 接口见 skills/tty7/SKILL.md

通过以下命令安装 skill

npx skills add l0ng-ai/tty7

基准测试

同一台机器、同一天、统一 155×40 网格 —— Apple M1 PromacOS 26.3.1 取五次运行的平均值(2026-07-04):

tty7 Alacritty Ghostty Kitty
纯文本 I/O —— 11 MB cat (越低越好) 95 ms 239 ms 179 ms 185 ms
DOOM-fire 帧率 (越高越好) 888 fps 485 fps 552 fps 617 fps
冷启动内存 116 MB¹ 105 MB 128 MB 130 MB

¹ GUI 105 MB + 常驻 server 11 MB。

测试方法与一键复现脚本:scripts/bench/