agterm

一款原生 macOS 终端,以命名工作区组织会话,并通过完整的控制 API 和 agtermctl 命令行让脚本与编码 Agent 精确驱动每一个会话。

Star 数
★ 751
最近更新
今天
License
MIT
主语言
Swift

30 秒速览

运行形态
桌面应用命令行工具Agent 插件 / 技能
可在哪里用
平台专用Codex · Claude Code
费用
免费,无需付费服务
上手难度
低 · 几分钟可跑通
开始前需要
macOS 14+Apple Silicon(arm64)作为登录 shell 的 zsh(用于实时会话恢复)Shell / 命令行本地文件系统
典型场景
并行运行多个编码 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 ★

这个 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 命令绑定到快捷键。

  1. 并行运行多个编码 Agent 的开发者:每个 Agent 占一个命名会话并上报状态,一眼看出哪个被阻塞或已完成,无需逐个切换标签页。
  2. 用 Claude Code 或 Codex 工作的工程师:安装 Agent Skill 后,Agent 可以自己创建工作区、分屏、运行浮层程序并内联显示图片,无需人工解释 API。
  3. 需要可脚本化终端的自动化爱好者:用 agtermctl 写脚本搭建布局、驱动非当前会话、回读输出并根据退出状态做出反应。
  4. 同时处理多个项目的日常用户:用 work/personal 等工作区组织会话,退出后按三种模式之一恢复布局或保持进程存活。
  5. 喜欢自己定制快捷键的用户:在 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 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
agterm 当前 75 · 存在缺口 桌面应用免费 ★ 751 今天 Swift Codex · Claude Code
chartr 65 · 存在缺口 桌面应用免费 + 模型费 ★ 355 9 天前 Rust —
cmux 79 · 表现良好 桌面应用免费版 + 付费版 ★ 29k 今天 Swift Codex · Claude Code
Calyx 72 · 存在缺口 桌面应用免费 ★ 365 24 天前 Swift Codex · Claude Code

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
存在缺口
为什么不是更高等级:信任与安全维度为 17/29,未达「表现良好」所需的 18/29,按「风险不做平均」下调评级。
75/ 100 五分制 3.8 / 5
本评测基于 2026年11月7日 的源码;此后该项目发布了 4 个正式版本,尚未复审。分数与结论只代表评测时的版本。 最近版本 ↓
信任安全 17/29
可靠稳定 9/14
适用触发 16/18
规范维护 16/18
有效结果 12/13
证据核验 5/8
查看各维度的扣分理由
信任安全17 / 29 · 2.9/5

证据显示控制面通过本地 Unix socket,命令面向可指定的会话,README 也说明脚本可输入命令、读取终端文本、运行覆盖程序和发送通知;Ghostty 固定到上游提交并注明借鉴代码来源,支持最小权限、数据流和依赖来源的较好评分。扣分原因:材料没有说明 socket 的授权边界、敏感终端文本的保护方式或破坏性命令的确认机制;安装钩子和插件的撤销步骤也不充分。

可靠稳定9 / 14 · 3.2/5

README、故障排除文档和 CI 文件共同描述了会话、控制 API、配置加载及构建检查;故障排除资料给出了日志位置、诊断和常见失败情形。扣分原因:若干产品能力只在 README 中作陈述,所给材料未提供实现与这些陈述逐项对应的证据,也未执行验证。

适用触发16 / 18 · 4.4/5

产品明确面向 macOS 上的多项目终端与并行编码代理工作流,同时说明可用于一般终端任务;扩展模型、skill 触发语句和“不用于 diff”的边界描述具体。扣分原因:发行版限于 Apple Silicon、macOS 14 以上,实时恢复另有 shell 要求,不能视为跨环境适配充分。

规范维护16 / 18 · 4.4/5

README 将用户指南、命令参考、cookbook、架构、故障排除和贡献说明分开;安装、命令示例、限制、MIT 许可和插件版本均有记录。扣分原因:给出的插件版本不构成清晰的发布历史,材料也未明确维护者的长期责任或更新承诺;发布者身份按题设仍属未知。

有效结果12 / 13 · 4.6/5

CLI 命令示例展示了可复用的工作区、会话、分屏、状态、选择器和询问流程;本地控制 API 对多会话代理终端有明确增益,且可用脚本扩展。扣分原因:控制面广且需要安装、配置并理解会话模型,常见收益仍取决于用户是否采用代理并行工作流。

证据核验5 / 8 · 3.1/5

README 的能力说明在命令示例、故障排除说明、技能文件及 CI 配置中得到部分交叉支撑,文档也列出具体操作和限制。扣分原因:样本没有包含核心实现,很多能力仍是产品文档中的声明;CI 配置只能证明存在自动化流程,不能据此断言测试通过或产品行为正确。

风险与缓解建议
  • 在让代理使用控制 API 前,审查其可输入命令、读取终端缓冲区和运行覆盖程序的权限及目标会话;材料未说明 socket 的访问控制细节。
  • 发行说明面向 Apple Silicon、macOS 14 及以上;实时恢复要求 zsh 或 fish,远程会话也要求另一台 Mac 使用实时会话模式和基于密钥的 SSH。
证据充分度:低 评估于 2026年11月7日 审查版本 dd324078216d 评估后仓库已有新提交,评分可能未覆盖最新改动
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/agterm.svg?lang=zh)](https://followagents.com/zh/agents/agterm)
<a href="https://followagents.com/zh/agents/agterm"><img src="https://followagents.com/badge/agterm.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. 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 查看 ↗
  2. 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 查看 ↗
  3. 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 吗?
官方预编译发行版仅支持 Apple Silicon(arm64)Mac、macOS 14 及以上。Linux 可看社区移植 agterm-linux(GTK4),Windows 可看独立重写项目 agwinterm,但它们不在本仓库维护范围内。
Agent 状态和 Skill 是不是一种特殊的 Agent 专属模式?
不是。README 明确说明这是与其他脚本完全相同的控制接口:状态钩子只是把 Agent 的 active/blocked/completed 写到会话行,Skill 只是教会 Agent 使用 agtermctl。不装任何 Agent,它仍是一个通用终端。
Live 会话恢复有什么前提和限制?
需要 zsh 作为 macOS 登录 shell,且重启 agterm 后生效。恢复后可保留运行中的进程和 TUI 状态,但不保留内联图片、OSC 133 标记、程序改过的调色板和超链接元数据;硬断电、强退或被 restore-denylist.conf 拒绝的命令会退回到新 shell。
它是免费的吗?采用什么许可?
项目采用 MIT 许可,预编译发行版免费下载,Homebrew cask 也可直接安装。
输出是实时流式的吗?脚本怎么读取会话内容?
终端输出不流式传输。脚本需要时用 agtermctl session text --lines N 按需读取缓冲区;另外 session type 在按键入队后即返回,紧随其后的读取需要考虑与 shell 的竞态。
agterm 官网是什么?
agterm 的 GitHub 仓库填写的官网是 https://agterm.com。这个链接由仓库作者设置;源码在 GitHub(umputun/agterm)。
agterm 安全吗?
FollowAgents 的 FARS 评审(2026年11月7日)给 agterm 的“信任与安全”打了 17/29 分。评审检查的 8 项安全措施没有完全缺失的。评审之后仓库已有更新。
agterm 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-11-16,在最近 30 天内。最新版本是 v0.42.3(2026-11-14)。
agterm 是谁开发的?
agterm 由 GitHub 账号 umputun 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念