agterm
一款原生 macOS 终端,以命名工作区组织会话,并通过完整的控制 API 和 agtermctl 命令行让脚本与编码 Agent 精确驱动每一个会话。
- Star 数
- ★ 751
- 最近更新
- 今天
- License
- MIT
- 主语言
- Swift
- FA 评分
- 75/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用Codex · Claude Code
- 费用
- 免费,无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 并行运行多个编码 Agent 的开发者:每个 Agent 占一个命名会话并上报状态,一眼看出哪个被阻塞或已完成,无需逐个切换标签页。
- 不适合
- 使用 Intel Mac、Linux 或 Windows 的用户,官方仅支持 Apple Silicon 与 macOS 14+
- 需要开箱即用完整功能、不愿写 keymap.conf 或脚本的用户
- 依赖 zsh 以外登录 shell 且要求会话实时恢复的团队
- 官网
- agterm.com ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-16最新版本 v0.42.3(2026-11-14)近 7 天每天 +2.0 ★
- 源码审查
- 75/100 · 存在缺口
这个 Agent 能做什么,适合哪些场景?
agterm 是一款专为 Apple Silicon Mac 打造的原生 macOS 终端,采用刻意精简的界面设计,核心模型只有一层:窗口包含命名工作区,工作区包含命名会话。它内置 agtermctl 命令行工具,通过本地 Unix socket 驱动几乎所有功能,包括创建会话、注入按键、回读终端文本、在浮层中运行程序、设置状态标记、移动窗口等。它嵌入 Ghostty 的 libghostty 引擎负责真正的终端渲染、VT 解析和 shell I/O,模型、侧边栏、持久化和控制通道则是 agterm 自身的代码。针对同时运行多个编码 Agent 的场景,每个 Agent 在自己的会话中报告 active、blocked 或 completed 状态,侧边栏一眼可见哪个 Agent 需要人工介入。可安装的 Agent Skill 教会 Claude Code 或 Codex 整套控制模型,使 Agent 能自主搭建布局、运行浮层并内联显示图片,而这并非特殊的 Agent 模式,而是与普通脚本相同的控制接口。
agterm 将 shell 会话组织在命名工作区下,支持会话的水平和垂直分屏、临时 scratch 终端,以及在全屏或浮动浮层(overlay)中运行 yazi、git UI 等程序而不干扰底层 shell。agtermctl 通过本地 socket 提供完整控制面:agtermctl workspace new demo 创建工作区,agtermctl session new --workspace "$ws" --cwd "$PWD" 创建会话,session split on --axis horizontal 分屏,session type $'pwd\n' --target "$sid" 向会话注入按键,session text --lines 10 回读终端缓冲区,session status blocked 设置侧边栏状态图标,pick 和 ask 打开原生选择器/对话框,tree -- 输出整个模型的状态。恢复模式有三种:用新 shell 恢复保存的布局、重跑退出时捕获的命令,或通过 zmx 让实际进程保持存活(要求 zsh 为登录 shell)。Agent 状态钩子(Help 菜单安装)支持 Claude Code、Codex、Pi、OpenCode 等 Agent 将自身状态上报到会话行;keymap.conf 中的一行 command 可把任意 shell 命令绑定到快捷键。
- 并行运行多个编码 Agent 的开发者:每个 Agent 占一个命名会话并上报状态,一眼看出哪个被阻塞或已完成,无需逐个切换标签页。
- 用 Claude Code 或 Codex 工作的工程师:安装 Agent Skill 后,Agent 可以自己创建工作区、分屏、运行浮层程序并内联显示图片,无需人工解释 API。
- 需要可脚本化终端的自动化爱好者:用 agtermctl 写脚本搭建布局、驱动非当前会话、回读输出并根据退出状态做出反应。
- 同时处理多个项目的日常用户:用 work/personal 等工作区组织会话,退出后按三种模式之一恢复布局或保持进程存活。
- 喜欢自己定制快捷键的用户:在 keymap.conf 写一行 command,即可把文件管理器或数据库浏览器以浮层形式绑到快捷键上。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
brew install --cask umputun/apps/agterm
- 安装说明涉及
- macOS
如何安装或部署这个 Agent?
agterm 仅支持 Apple Silicon(arm64)、macOS 14 及以上,发行版已签名并经 Apple 公证。Homebrew 安装:brew install --cask umputun/apps/agterm(cask 会同时安装 agtermctl)。或从 GitHub Releases 下载 .dmg,将 agterm.app 拖入 /Applications,再通过 Help ▸ Install Command Line Tool… 安装 agtermctl。Agent Skill 既可从 Help ▸ Install Agent Skill… 安装,也可作为插件安装(两条路只选其一):claude plugin marketplace add umputun/agterm && claude plugin install agterm@agterm,或 codex plugin marketplace add umputun/agterm && codex plugin add agterm@agterm。Agent 状态钩子从 Help ▸ Install Agent Status Hooks… 安装。
如何使用这个 Agent?
启动 agterm 后,会话按命名工作区组织,可通过名称、最近使用或键盘切换。典型脚本流程:ws=$(agtermctl workspace new demo) 创建工作区;sid=$(agtermctl session new --workspace "$ws" --cwd "$PWD" --no-select) 创建会话;agtermctl session split on --axis horizontal --target "$sid" 分屏;agtermctl session type $'pwd\n' --target "$sid" 注入按键;agtermctl session text --target "$sid" --lines 10 回读输出(注意 session type 仅在按键入队后返回,随后的读取存在竞态);agtermctl session status blocked --target "$sid" 设置状态图标;agtermctl tree -- 导出全量状态。自定义通过 keymap.conf 中的 command 行绑定快捷键,恢复策略在 Settings ▸ General ▸ Restore sessions 中选择,或用 agtermctl restore mode 直接读写。所有命令的完整参考见 agterm.com/commands。
这个 Agent 有哪些优点和局限?
- 完整的本地 socket 控制 API:脚本和 Agent 可以创建会话、注入输入、回读终端缓冲区、读取状态,这是多数终端不具备的可编程能力。
- 为多 Agent 并行场景专门设计的状态上报:active/blocked/completed 直接显示在侧边栏会话行,配合 Claude Code、Codex、Pi、OpenCode 等钩子即装即用。
- 嵌入成熟的 libghostty 引擎处理渲染和 VT 解析,同时保持精简的功能面,不做深层 Agent 集成,把扩展权交给用户和脚本。
- 三种恢复模式(含基于 zmx 的真进程保活),重启后会话进程可继续存活并重新附着。
- 平台绑定严格:仅支持 Apple Silicon Mac 和 macOS 14+,Linux 和 Windows 需依赖第三方移植或独立仿制项目。
- Live 会话恢复要求 zsh 作为 macOS 登录 shell,且需重启 agterm 才生效;硬断电或强制退出无法捕获命令。
- 会话恢复有明确的能力边界:内联图片、OSC 133 提示符标记、调色板改动和超链接元数据在重新附着后不会保留。
- 扩展依赖自己动手:超出默认功能需要写 keymap.conf 的 command 行或脚本,对不愿定制的用户是额外成本。
这个 Agent 与同类方案有什么区别?
README 明确将 agterm 与分页签终端对比(后者在多 Agent 长会话下容易失控),并列出了生态中的相关项目:melonamin/agterm-linux 是基于 agtermCore 的 Linux/GTK4 移植,jokius/rook 是走向不同方向的 macOS 原生分支,yeroo/agwinterm 是面向 Windows 的独立重写。agterm 的差异化在于:不追求功能堆叠,而是提供完整控制 API 让用户和 Agent 自行扩展。
与相关度最高的同类 agent 并排比较关键指标。
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
证据显示控制面通过本地 Unix socket,命令面向可指定的会话,README 也说明脚本可输入命令、读取终端文本、运行覆盖程序和发送通知;Ghostty 固定到上游提交并注明借鉴代码来源,支持最小权限、数据流和依赖来源的较好评分。扣分原因:材料没有说明 socket 的授权边界、敏感终端文本的保护方式或破坏性命令的确认机制;安装钩子和插件的撤销步骤也不充分。
README、故障排除文档和 CI 文件共同描述了会话、控制 API、配置加载及构建检查;故障排除资料给出了日志位置、诊断和常见失败情形。扣分原因:若干产品能力只在 README 中作陈述,所给材料未提供实现与这些陈述逐项对应的证据,也未执行验证。
产品明确面向 macOS 上的多项目终端与并行编码代理工作流,同时说明可用于一般终端任务;扩展模型、skill 触发语句和“不用于 diff”的边界描述具体。扣分原因:发行版限于 Apple Silicon、macOS 14 以上,实时恢复另有 shell 要求,不能视为跨环境适配充分。
README 将用户指南、命令参考、cookbook、架构、故障排除和贡献说明分开;安装、命令示例、限制、MIT 许可和插件版本均有记录。扣分原因:给出的插件版本不构成清晰的发布历史,材料也未明确维护者的长期责任或更新承诺;发布者身份按题设仍属未知。
CLI 命令示例展示了可复用的工作区、会话、分屏、状态、选择器和询问流程;本地控制 API 对多会话代理终端有明确增益,且可用脚本扩展。扣分原因:控制面广且需要安装、配置并理解会话模型,常见收益仍取决于用户是否采用代理并行工作流。
README 的能力说明在命令示例、故障排除说明、技能文件及 CI 配置中得到部分交叉支撑,文档也列出具体操作和限制。扣分原因:样本没有包含核心实现,很多能力仍是产品文档中的声明;CI 配置只能证明存在自动化流程,不能据此断言测试通过或产品行为正确。
- 在让代理使用控制 API 前,审查其可输入命令、读取终端缓冲区和运行覆盖程序的权限及目标会话;材料未说明 socket 的访问控制细节。
- 发行说明面向 Apple Silicon、macOS 14 及以上;实时恢复要求 zsh 或 fish,远程会话也要求另一台 Mac 使用实时会话模式和基于密钥的 SSH。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
v0.42.3 Version 0.42.3
发布说明摘录
Bug Fixes - Switching to or from a left/right split session with the compact toolbar no longer flickers at the top. Every switch resized both panes by about two rows, so the shells redrew and a stale frame showed under the titlebar; the panes now keep their size. A top/bottom split can still jump its divider for one frame when shown #995 @umputun …在 GitHub 查看 ↗ -
v0.42.2 Version 0.42.2
发布说明摘录
Bug Fixes - Live sessions no longer close when macOS force-quits a program started in one. A GUI program switched off in System Settings ▸ General ▸ Login Items ▸ Allow in the Background, started from a live session after agterm had been quit and opened again, was force-quit by macOS about 30 seconds later, and the live sessions macOS had grouped with it closed too. On macOS 27 and later agterm starts the session host as its own background job, so the force-quit reaches only the program. Sessions started before this update keep their old host until Agterm ▸ Reset Live Sessions… moves …在 GitHub 查看 ↗ -
v0.42.1 Version 0.42.1
发布说明摘录
Improved - Log pages and text-page controls on remote sessions. A log ⌘-clicked in a session attached from another Mac opens as a log page there, and Follow, search, Wrap and change steps work on it as on a local page. session overlay follow|search|wrap|changes from the origin reach the page on the presenting Mac; a Mac on 0.42.0 gets the plain text page and refuses those controls. agterm-server serves log pages too, and its page rows show in a Mac's remote window #978 @umputun …在 GitHub 查看 ↗
常见问题
它支持 Intel Mac 或 Linux/Windows 吗?
Agent 状态和 Skill 是不是一种特殊的 Agent 专属模式?
Live 会话恢复有什么前提和限制?
它是免费的吗?采用什么许可?
输出是实时流式的吗?脚本怎么读取会话内容?
agtermctl session text --lines N 按需读取缓冲区;另外 session type 在按键入队后即返回,紧随其后的读取需要考虑与 shell 的竞态。agterm 官网是什么?
agterm 安全吗?
agterm 还在维护吗?
agterm 是谁开发的?
谢谢反馈,我们会据此改进页面。