
30 秒速读:同时开四五个终端跑 Claude Code 和 Codex,人肉来回切屏看进度——哪个 Agent 卡住了全靠猜,上下文分散在各个窗口里,谁也看不全。本篇讲的是 Polter:一个基于 Ghostty 与 MCP 的多 Agent 终端编排工具,它让一个 Claude Code Supervisor 通过内置 MCP 服务器读取其他终端标签页的真实文本、代输命令、创建新标签页,配合屏幕活动停滞检测、Roles / Projects、AI 截图标注,把”多 Agent 并行”变成可集中管理的编排。关键词:polter。
软件信息一览
| 项目 | 说明 |
|---|---|
| 项目名称 | Polter |
| 项目定位 | 基于 Ghostty 的终端复用与 AI Agent 编排工具 |
| 技术栈 | Zig 开发,基于 Ghostty 终端工作方式 |
| 编排方式 | 一个 Claude Code Supervisor + 多个独立终端 Worker,内置 MCP 服务器 |
| Supervisor 能力 | 读取其他终端标签页真实文本、输入命令、创建新标签页;Worker 输出逐行写盘便于检索 |
| 钩子支持 | Claude Code、Codex、OpenCode 有钩子通知;Antigravity 仅 macOS;其他 CLI 靠屏幕活动监控 |
| 组织能力 | Roles(保存 Agent 技能、提示词、模型设置)、Projects(保存标签页、目录、历史记录)、群聊任务面板 |
| 视觉能力 | AI 截图工具:文字和框选标注保存为可读数据,图片旁生成 JSON 文件 |
| 停滞感知 | 按屏幕活动跟踪闲置时间,Worker 停滞时向 Supervisor 发通知 |
| 平台 | macOS / Windows(Roles、Projects 明确标注;其他平台公开信息有限) |
| 扩展 | 7 个 provisioning 插件、Agent Hooks、插件机制 |
| 许可证 | 以仓库 LICENSE 文件为准(使用前请先确认) |
版本选择:先在 macOS 或 Windows 上把 Supervisor 跑起来,别一上来就配全套
结论先行:第一次上手的目标只有一个——让 Supervisor 能”看见”并操作另一个终端标签页。Roles、Projects、插件这些组织能力是”跑顺之后”的加分项,一开始全配上,只会让你分不清问题出在编排层还是配置层。
| 取用方式 | 适合谁 | 风险点 |
|---|---|---|
| 仓库源码直接用 | 想第一时间跟进功能、愿意自己构建的人 | 构建依赖和文档可能超前,README 没写的坑要自己填 |
| 等官方 Release | 希望开箱即用、不想折腾构建的人 | 发版节奏未知,急着用就别等 |
| 跑顺后锁定版本自用 | 已把 Supervisor + 钩子 + Roles 配顺的日常工作流 | 上游更新要手动跟进,锁太死会错过停滞检测等改进 |
推荐路线:源码跑通 Supervisor 可见性 → 给主力 Agent(Claude Code / Codex / OpenCode)配好钩子 → 再加 Roles 和 Projects 沉淀 → 日常高频用了再考虑锁定版本。版本策略以仓库实际发布说明为准。
上手只盯 4 个卡点
- Ghostty 是地基,先确认它能跑。Polter 基于 Ghostty 的终端工作方式,整个编排都长在 Ghostty 之上。平台上 Ghostty 跑不起来,后面全免谈——先把终端本身跑通,再谈 Agent 编排。
- MCP 接入是 Supervisor 的”眼睛和手”。读其他标签页文本、代输命令、创建新标签页,全靠内置 MCP 服务器。验证标准很具体:让 Supervisor 读出另一个标签页当前显示的文本,读不出来就是 MCP 没接好。
- 钩子按 Agent 对号入座。Claude Code、Codex、OpenCode 有钩子通知,Antigravity 只在 macOS 上支持,其他 CLI 只能靠屏幕活动监控。先确认你的主力 Agent 在不在钩子名单里——不在的话,停滞感知的精细度要打折扣。
- AI 截图先跑一次看落盘。截图工具会把文字和框选标注存成可读数据,并在图片旁生成 JSON。先手动触发一次,确认文件真的落盘了、JSON 能被 Agent 读到,再把它当”视觉上下文”用。
落地前必做的 4 项配置
- Supervisor 代操作权限策略。入口:每个标签页或全局策略配置。体感差别:这是”只读观察”还是”可以动手”的分界线——Supervisor 能代输命令、能处理终端权限提示,策略没配好,它替你点的那个 yes 你可能到出事才知道;自动应答必须配人工复核。
- 停滞检测阈值。入口:屏幕活动跟踪配置。体感差别:按屏幕活动算闲置、Worker 停滞时通知 Supervisor——阈值设太短全是误报,设太长等于没这个功能,先按你的任务节奏调一轮再定。
- Roles:把常用 Agent 角色沉淀下来。入口:Roles 配置(技能、提示词、模型设置)。体感差别:开新 Worker 时一键套用,不用每次重讲一遍”你是谁、用什么模型、遵守什么规范”;角色越多,省下的重复交代越多。
- Projects:把工作现场打包。入口:Projects 配置(标签页、目录、历史记录)。体感差别:一个项目的所有终端布局和目录一次保存,下次打开直接回到上次的工作现场,适合长期并行的多任务。
先看 4 条注意事项,再决定用不用
- 它是终端原生方案,不是通用 Agent 平台。依赖 Ghostty 终端工作方式和命令行 Agent 会话,非终端型 Agent 的适配范围要结合 README 或源码确认,别指望它管图形界面的 Agent。
- 高级钩子只覆盖三家。Claude Code、Codex、OpenCode 有完整钩子支持,Antigravity 限定 macOS,其他 CLI 主要靠屏幕活动监控——监控精细度不在一个级别,选型时先对好你的 Agent 清单。
- 跨平台支持公开信息有限。Roles、Projects 明确标注 macOS 和 Windows 可用,其他操作系统的支持情况公开信息有限,Linux 用户先验证再规划,别按”跨平台工具”做假设。
- 自动应答权限提示是安全口子。Supervisor 可代为处理终端权限提示,但”自动应答”配错了等于把确认环节交出去。给每个标签页或全局定一个明确的人工复核策略,再开自动。
适合谁用:终端里同时跑多个编码 Agent 的人
适合:需要并行运行多个 Claude Code / Codex(或其他命令行编码 Agent),想集中查看状态、分配任务、处理停滞提示的开发者;终端原生工作流的重度用户。
不适合:只用单个终端会话、偏好传统终端复用器、或者 Agent 本来就不在命令行里跑的人——对他们来说,Polter 的编排能力用不上,徒增复杂度。
横向看一眼:tmux / zellij 只解决”终端复用”,不管 Agent 死活;Polter 是”复用 + MCP 编排 + 停滞感知”,多 Agent 并行第一次有了中央调度;要的是图形化 Agent 管理或更广的插件生态,它目前还给不了,公开信息也不足以证明。
一句话总结:Polter 最值钱的不是”又一个终端复用器”,而是让 Supervisor 真正”看得见、摸得着”其他终端——读真实文本、代输命令、开标签页,再配上停滞通知和 Roles / Projects,多 Agent 并行第一次有了”中央调度”的样子。终端原生、多 Agent 并行是你的日常,它就值得一试。
开源地址
GitHub 国内访问较慢,如打不开可多刷新几次

关注「软件教程管家」
回复软件名即取即下:网盘下载链接 + 提取码,一步直达,不用再跳转。
本站资源仅供个人学习交流,请勿用于商业用途。软件与资料版权归原作者所有;如有侵权,请通过公众号「软件教程管家」联系我们,我们将在 24 小时内下架处理。查看免责声明 ›







