Polter 多终端智能体监督器
让一个 Claude Code 会话监督其他终端中的独立智能体。
- Star 数
- ★ 20
- 最近更新
- 今天
- License
- MIT
- 主语言
- Zig
- FA 评分
- 47/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配Claude CodeCodex(部分支持)
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 同时运行多个 Claude Code 会话的开发者,可指定一个会话分派任务并汇总各终端的报告。
- 不适合
- 需要无人值守跑完长任务的团队:权限提示仍需人工处理
- Linux 用户:官方不提供二进制,只能自行编译
- 需要完整任务管理系统的团队:面板只记录归属与完成
- 源码审查
- 47/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
Polter 是 Ghostty 的分支,把终端模拟器与多智能体监督能力组合在同一个桌面应用中。它将一个普通的 Claude Code 终端标记为 supervisor,使该会话能通过 MCP 读取其他标签页的文本、向其中输入内容、创建新标签页并启动独立智能体。协作记录由聊天 TUI 和任务面板呈现,终端转录、任务变更、聊天及每小时统计均保存到 $XDG_STATE_HOME/polter/。工作会话彼此独立,而不是某个模型会话内部的子智能体,因此每个工作者产生的文件修改会直接写入共享磁盘。Polter 本身不需要账户或 API 密钥,除非用户主动检查更新,否则不会自行发起网络请求;但它仍要求启动时 PATH 中存在可用的智能体 CLI。目前只有 Claude Code 经过测试,macOS 和 Windows 提供下载包,Linux 需要从源码构建。
用户先在一个终端标签页中启动 Claude Code,再通过 Agents → Make This Terminal a Supervisor 将其设为监督者;Polter 会向该标签页输入提示,要求会话读取 supervising skill。监督会话可调用 MCP 工具读取任意标签页屏幕上的文本、通过粘贴路径向标签页发送文本、打开新标签页并在其中启动智能体。它还能建立持久化群聊、分配任务、接收报告,并根据屏幕保持不变的时间发送静止提醒;它不会解析 CLI 输出,也不会自行判定智能体究竟是卡住还是正在思考。Agents → Terminal Conversations 或 polter +chat 打开聊天界面,tab 和 shift+tab 可在会话、任务面板及运行统计三个视图之间切换。src/poltergeist/、MCP 工具层、聊天 TUI、终端转录和插件宿主是 Polter 在 Ghostty 基础上增加的主要组件。运行数据分别写入 $XDG_STATE_HOME/polter/chat/、terminals/、tasks/ 和 stats/,且不会自动脱敏。
- 同时运行多个 Claude Code 会话的开发者,可指定一个会话分派任务并汇总各终端的报告。
- 执行长时间或通宵编码任务的用户,可根据终端画面静止时长发现可能已停止推进的会话。
- 需要让多个独立会话直接协作同一工作目录的团队,可保留每个终端的逐行转录并在次日使用
grep检查。 - 希望在终端内部保留轻量任务归属和完成状态的用户,可使用持久化群聊与任务面板,而无需引入完整项目管理系统。
- 开发 MCP 客户端或智能体 CLI 集成的工程师,可利用其标准 MCP 服务和随附的七个 provisioning 插件进行试验,但 Claude Code 之外的客户端需自行验证。
如何安装或部署这个 Agent?
先确保一个智能体 CLI 在 PATH 中,并且在 Polter 启动时仍可找到。该项目仅明确测试过 Claude Code;Polter 自身不需要账户或 API 密钥,而智能体 CLI 的认证方式未在给定资料中说明。
macOS 13 或更高版本应从 Latest release 下载 Polter-*-macos-universal.zip,然后执行:
unzip Polter-*-macos-universal.zip
xattr -dr com.apple.quarantine Polter.app
mv Polter.app /Applications/之后必须从 Finder 或 Dock 打开 Polter;从终端启动时 PATH 可能不同,provisioning 插件可能找不到智能体 CLI。
Windows 10 或更高版本应下载并解压 Polter-*-windows-x64.zip,运行 polter-host.exe,并将两个 DLL 和 share/ 保留在可执行文件旁。遇到 SmartScreen 时选择“Run anyway”。资料称 Windows 已实现核心 76 个动作中的 70 个,另有 4 个明确拒绝、2 个尚未实现。
Linux 没有预编译二进制,需要从源码构建。给定资料只指出构建说明位于 dev-docs/preview-manual.md,未提供可复制的 Linux 构建命令。
如何使用这个 Agent?
- 打开一个 Polter 标签页,进入目标工作目录并启动 Claude Code。
- 选择
Agents → Make This Terminal a Supervisor。Polter 会提示该会话读取supervisingskill。 - 在监督会话中输入以下验证请求:
Call the `me` tool and tell me what it says.如果返回终端 ID,说明 MCP 工具已可用;如果没有 me 工具,应检查插件是否关闭、Polter 启动时 claude 是否在 PATH 中,以及 poltergeist-register-mcp 是否被关闭。
- 直接告诉监督会话要完成的工作,无需手动提供终端 ID 或工具名称;监督者可自行建立群组、打开标签页、认领终端并跟踪时间。
- 使用
Agents → Terminal Conversations或以下命令查看协作记录:
polter +chat在聊天 TUI 中用 tab 和 shift+tab 切换会话、任务面板和统计视图。默认设置可直接运行;poltergeist-watch 控制屏幕采样,poltergeist-quiescence-after 控制静止多久后提醒,poltergeist-register-mcp 控制启动时是否注册 MCP 服务。
这个 Agent 有哪些优点和局限?
- 监督者可以读取和操作独立终端会话,而工作者并非易在长任务中中断的会话内子智能体。
- 采用纯文本屏幕读取和标准 MCP 接口;Polter 自身无需账户或 API 密钥,日常监督也不需要其自行联网。
- 群聊、任务变更、终端转录和小时统计均持久化到本地,应用重启后仍可检查工作过程。
- 基于 Ghostty 保留其渲染器、VT 实现、字体栈和原生 UI,同时增加 MCP 工具层、聊天 TUI 与插件宿主。
- 对权限边界采取保守设计:不会代替智能体回答权限提示,也不能让智能体解除用户设置的锁定或保护。
- 只有 Claude Code 得到明确测试;Codex 虽在使用场景中被提及,其他 MCP 客户端和七个 provisioning 插件均应视为未经验证。
- 所有聊天和终端记录都不会脱敏,采用前必须把
$XDG_STATE_HOME/polter/当作包含敏感 shell 历史的数据目录管理。 - 静止检测只测量屏幕多久未变化,不解析 CLI 状态,因此无法可靠区分卡死和长时间思考。
- 不能处理智能体权限提示,也不能绕过智能体自身权限,长时间无人值守任务仍可能等待人工介入。
- Windows 的核心动作尚未全部实现;Linux 没有发布二进制,必须自行构建。
- 任务面板仅记录任务归属和完成状态,项目明确不打算把它扩展成完整任务管理系统。
这个 Agent 与同类方案有什么区别?
与 tmux 相比,Polter 不只是复用终端:它增加了 MCP 控制、跨标签页文本读取与输入、静止时长提醒、持久化群聊和任务面板。与 Ghostty 的关系不是竞争或重写;Polter 直接分叉 Ghostty,沿用其终端渲染、VT、字体和原生 UI,并在其上增加 src/poltergeist/、MCP 工具层、聊天 TUI、转录与插件宿主。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Polter 多终端智能体监督器 当前 | 47 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 20 | 今天 | Zig | Claude Code |
| MassGen 多智能体协作系统 | 50 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 1.1k | 4 个月前 | Python | Codex · Claude Code · OpenAI API · Claude API |
| tRPC-Agent-Go | 56 · 缺口较多 | 代码库 / SDK免费 + 模型费 | ★ 1.9k | 今天 | Go | OpenAI API |
| BeeAI Framework | 50 · 缺口较多 | 代码库 / SDK免费 + 模型费 | ★ 3.5k | 5 天前 | Python | — |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
安全文档描述令牌认证、监督员权限、屏蔽终端和本地套接字限制,README也说明可关闭自动代答;因此最小权限、确认机制和回滚均只得部分分:文档同时指出截图默认允许持令牌的任意代理访问,且终端代答开关默认开启。数据流有本地存储、事件过滤和有限更新请求的说明,得分较高;但截图、终端内容和敏感数据保护并未在所给证据中充分覆盖。依赖安全只看到依赖与构建配置,缺少漏洞处置证据。安全文档明确区分代码事实、限制和路线图推测;Ghostty及其许可证有明确归属。
文档详细记录测试过滤陷阱、构建竞态和看门狗用途,但 README 的广泛产品承诺与本包可见的静态代码证据并未逐项互证,因此自洽性仅部分成立。CI展示了构建和测试配置,但没有足够证据说明所有外部工具及运行环境的可用性。插件在子进程错误时静默丢弃事件,虽避免阻塞宿主,却降低故障可见性。
README面向需要协调多个终端代理的开发者,给出监督员、工作终端和常见 CLI 的场景。安全文档说明监督员、插件及未标记终端的能力边界,但默认截图访问和自动代答降低了边界的保守性。所示技能触发条件明确,但它只是提交信息技能,不能据此证明整个产品的触发精度。安装说明覆盖 macOS、Windows 和 Linux 构建,不过平台差异、未签名安装及插件版本约束限制了适配程度。
README按安装、快速开始、功能、安全、架构和FAQ组织,且提供平台安装步骤与示例。MIT许可证及上游版权归属清楚。部分分数来自已知限制的明确记录,包括Linux截图模块尚未移植、插件版本要求和静默事件丢弃;扣分原因是版本演进与维护责任信息有限,且样本中的技能仅覆盖提交信息,不能证明整个技能目录的命名和导航稳定。
任务板、群聊、终端查看和资源面板针对多代理协作提供可操作输出,README也说明了主要工作流,因此有实际增益。扣分在于产品宣传声称自动化、持续交付和性能优势,但给出的样本不足以衡量普通用户的成本收益;代理可以读取和输入其他终端内容,使用收益依赖谨慎配置。
安全文档将不少安全主张指向函数与代码路径,插件代码也说明事件过滤、会话归属和队列行为;同时文档明确提醒代码优先,并区分测量、观察与推论。得分未满是因为本次材料只有部分源文件,README的许多性能、安全和对比主张没有在不同来源间得到充分佐证,静态审查也无法验证运行效果。
- 安全文档指出,持令牌的代理默认可使用截图功能;审慎配置截图访问与终端屏蔽设置。
- 监督员的终端代答开关默认开启,README称高风险操作会升级通知,但所给样本不足以验证分类效果。
- opencode 插件在 Polter 子进程失败时静默丢弃事件;监控集成是否持续上报时,应考虑该故障模式。
- README包含广泛的性能、安全和竞品比较主张;本次静态材料不能独立验证这些主张。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
v0.11.2239 Polter 0.11.2239
发布说明摘录
Polter 0.11.2239 — 53 commits since 0.11.2186, all of them this project's own. No upstream merge is in this one. The control room - Performance, tasks and chat pages beside the supervisor page, on macOS and on Windows, drawn from the core's answers. - The tasks page: a key bar under the list, a selected row that shows, hover, f to filter by title with the matches marked, closed tasks hidden and said so, and the list following the selection. On macOS a long list no longer redraws every row on every update, so scrolling it with a task open no longer drops frames. …在 GitHub 查看 ↗ -
v0.11.2186 Polter 0.11.2186
发布说明摘录
Polter 0.11.2186 — 51 commits since 0.10.2135, all of them this project's own. No upstream merge is in this one. Supervisors and workers - A project has one supervisor. Adding a second to its group is refused while the first is still minding it. - Workers stack to the supervisor's right. The first worker splits the supervisor's pane to the right, and every worker after it is stacked in front in that pane. Panes you opened yourself are never stacked into. Two launches close together: the second waits up to three seconds for the first. …在 GitHub 查看 ↗ -
v0.10.2135 Polter 0.10.2135
发布说明摘录
Polter 0.10.2135 — 130 commits since 0.10.2005, all of them this project's own. No upstream merge is in this one. More agent CLIs - Codex. A role can start Codex, and Polter learns its turns and approvals through Codex's own hooks, on macOS and on Windows. A Codex taken over goes on with its own session, and never with somebody else's: when Polter cannot tell which session in a directory is this one, it names none. Codex's skills and rules go under CODEX_HOME. - Antigravity CLI (agy). A supervisor or a worker can be agy. Polter never …在 GitHub 查看 ↗
常见问题
使用 Polter 是否需要额外账户、API 密钥或网络连接?
为什么监督会话找不到 Polter 工具?
claude 不在 PATH 中,或 poltergeist-register-mcp 被关闭。MCP 注册会指向最后启动的构建。它能自动处理权限提示或解除终端锁定吗?
它如何判断某个智能体卡住了?
可以使用 Claude Code 之外的智能体 CLI 吗?
谢谢反馈,我们会据此改进页面。