### 终端优先的 Agent 开发环境
[](https://github.com/termio-sh/termio/releases)
[](LICENSE)
[](https://discord.gg/H9DKVwsE5f)
English | 简体中文 | 繁體中文 | 日本語 | 한국어
在真实的 Mac 终端里并排跑 Claude Code、Codex 和任意 CLI Agent——
Swift 加 libghostty，没有 Electron。菜单栏的圆点告诉你哪个在等你，
人不在桌前的时候，iPhone 来告诉你。
[**下载 macOS 版**](https://downloads.termio.sh/termio.dmg) • [官网](https://termio.sh) • [文档](https://termio.sh/docs) • [更新日志](https://termio.sh/changelog) • [Discord](https://discord.gg/H9DKVwsE5f)
## 安装
**[下载 macOS 版 Termio](https://downloads.termio.sh/termio.dmg)**——免费，
不用账号，需要 macOS 14 或更高版本。也可以走 [Homebrew](https://brew.sh)：
```sh
brew install --cask termio-sh/tap/termio
```
**iPhone 端**：从
[TestFlight](https://testflight.apple.com/join/1Arf1UKR) 装伴侣应用的公测版，
再扫 Mac 应用 **设置 ▸ 手机** 里的二维码配对。
## 为 Agent 编程而造
IDE 是围绕一个人敲代码设计的。代码大半改由 Agent 写之后，开发环境的职责跟着变：
它既是 Agent 干活的地方，也是你指挥、审阅、给它们解困的地方。Termio 就是这样一个
环境——终端优先，因为 Agent 本来就住在终端里——它对着工作的新形状造：几个 Agent
同时在跑，大多数不用你管，有一个卡住了。（更完整的论述见
[*From IDE to ADE*](docs/essays/from-ide-to-ade.md)。）
- **真实的终端，不是网页视图。** Swift + AppKit，跑在
[libghostty](https://ghostty.org)（Ghostty 的终端内核）上，用 Metal 渲染。
没有 Electron，也没有 xterm.js。
- **项目 → 会话。** 侧栏映射你实际的工作方式：每个项目装着自己的终端和 Agent，
git worktree 嵌在项目下面，一条分支对应一项并行任务。
- **状态不用配。** Termio 自动接好每个 Agent 自带的 hook，读它们本来就会发出的
信号。工作中、空闲，还是*需要你*——每个会话一个状态点；菜单栏托盘平时安静，
Agent 干活时脉动，有 Agent 被你挡住时出声。
- **审阅不必离开。** 只读的 git 面板（更改、历史、统一 diff）、点击即编辑的文件树、
项目级内容搜索——提交仍然在终端里做。
- **Git worktree。** 从侧栏创建，以嵌套文件夹出现在项目下，一条分支对应一项并行任务。
- **聊天。** 不属于任何项目的一次性 Agent 会话。
- **用量仪表。** Claude 和 Codex 的套餐额度，在 **设置 ▸ 用量** 里本地读取。
- **主题。** 浅色、深色，以及跟随系统的玻璃外观。
- **自动更新。** 经过公证的 DMG，由 Sparkle 更新。
- **免费。** 不用账号，没有许可证密钥，也没有付费档位。MIT 许可。
## 和你现有的 Agent 一起用
Claude Code、Codex、Antigravity、Grok、Cursor Agent、Copilot、Amp、OpenCode、
Pi、Kimi——以及任何其他 CLI Agent，因为会话本来就是一个真实终端。
内置的那些，Termio 会自动装上它们各自的 hook 或插件，你第一次启动它们时状态检测
就已经在了。
## 从终端驱动
Termio 附带 `termio` 命令行工具，会话因此可以脚本化——Agent 自己也能调。跑在 Termio
里的 Agent 可以派生一个同伴，交给它一个任务，再把回复读回来：
```sh
termio . # 把当前目录作为项目打开
termio sessions list # 谁在工作、空闲，或在等你
termio sessions spawn "fix the flaky test" # 用一段提示启动新的 Agent 会话
termio sessions run "pnpm test --watch" # 用一条命令启动普通终端会话
termio sessions send ab12cd34 "1" # 回答同伴的权限确认
termio sessions read ab12cd34 --lines 40 # 打印某个会话当前的屏幕
termio sessions watch # 实时流式输出状态变化
termio sessions focus ab12cd34 # 在应用里把某个会话切到前台
termio sessions close ab12cd34 # 关掉它
termio notify "the migration finished" # 发一条 macOS 通知
```
剩下的交给参数：`--wait` 一直等到这一轮结束，回来时带上最终状态和可以去读的记录行
范围；`--json` 让任何 `sessions` 命令输出机器可读的结果；`--agent` 决定 `spawn`
启动哪个 Agent；`--direction` / `--ratio` 决定新面板落在哪、占多大。
```sh
termio sessions spawn "run the migration" --agent codex --wait
```
Agent 自己会学会这套：会话控制会往每个 Agent 的技能目录（`~/.claude/skills`、
`~/.codex/skills`）装一个 `termio`
[Agent 技能](https://termio.sh/skill.md)，并在每次启动时保持它最新。
其他 Agent 也可以直接从这个仓库装同一个技能：
```sh
npx skills add termio-sh/termio --skill termio
```
## 在你的 iPhone 上
伴侣应用把每个 Mac 会话实时镜像到手机上——是完整的 TUI，不是聊天摘要。按键条把
esc、tab、ctrl 和方向键放在键盘上方，按住说话把语音直接转写进提示词。免费，公测中：
[加入 TestFlight](https://testflight.apple.com/join/1Arf1UKR)。
微信二维码每几天失效一次。失效了就在 Discord 说一声，会换上新的。
## 贡献者