AgentBro
在桌面悬浮窗中监控、响应并集中管理本地 AI 编程 Agent。
- Star 数
- ★ 166
- 最近更新
- 3 个月前
- License
- Apache-2.0
- 主语言
- Rust
- FA 评分
- 78/100 · 表现良好
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 免费，无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 同时运行多个 Claude Code、Codex 或 Gemini CLI 会话的开发者，用灵动岛集中查看进度、审批请求和完成提醒。
- 不适合
- 需要 Linux 桌面版的团队，官方暂无正式版本且未列入发布计划
- 依赖 Windows 深度交互的用户，Windows 仍属早期 MVP 且部分能力缺失
- 希望完全免配置接入所有 Agent 的用户，各 Agent Hook 能力与事件覆盖不一致
- 源码审查
- 78/100 · 表现良好
这个 Agent 能做什么，适合哪些场景？
AgentBro 是面向 macOS 和 Windows 的本地优先桌面控制台，通过灵动岛式悬浮窗汇总多个 AI 编程 Agent 的会话状态、工具调用、审批、问题和完成提醒。它为 Claude Code、Codex、Gemini CLI、Cursor、GitHub Copilot、Kimi、OpenCode 等工具提供 Hook 接入，并通过 Agent Monitor 保存和查看当前及历史事件。Agent 管理模块扫描本机 CLI、桌面应用、版本、路径和配置，同时集中管理 Hooks、Skills、Skill Pack、MCP 服务及插件。Agent Switch 可配置和测速 Claude、Codex、Gemini、OpenCode 与 Hermes 的 API 供应商，SSH 功能则把远程主机上的 Hook 事件带回本机。应用使用 React、Rust 和 Tauri 构建，会话事件与本地配置无需云端中转；正式下载覆盖 macOS 和 Windows x64，但 Windows 当前仍是早期 MVP。
AgentBro 先通过 Hook Doctor 检查本地 Agent、路径和 Hook 状态，再使用 Install All Hooks 或单个 Agent 的安装操作部署适配器。Agent 运行后，Hook Server 在 macOS 上默认监听当前用户的本地 Unix Socket，在 Windows 上使用本地 TCP 端点；收到的权限请求、问题、计划、工具调用、文件 Diff、Subagent、Token、Rate Limit、完成结果和错误会进入灵动岛与 Agent Monitor。用户可在悬浮窗中批准权限、回答问题、确认计划，并对受支持的 Agent 快速回复。Agent 管理会扫描 CLI、桌面应用、Skills、MCP、插件、配置文件和项目级设置，可安装或修复 Hook、分发集中保存的 Skills、应用可撤销的 Skill Pack、检查 MCP 的 tools、resources、prompts 与连接日志，并在校验后编辑受支持的配置。Agent Switch 管理供应商配置、连通性测试和切换；SSH 模块从 ~/.ssh/config 导入主机，通过隧道接收远端 Hook 事件。可选功能还包括钉钉或飞书 Webhook 转发、Claude Code 本地网络 Inspector，以及由 abpets CLI 驱动的桌面宠物市场。
- 同时运行多个 Claude Code、Codex 或 Gemini CLI 会话的开发者，用灵动岛集中查看进度、审批请求和完成提醒。
- 经常在权限提示、问题和计划确认处等待的终端用户，直接从桌面悬浮窗响应支持的交互。
- 在多种编码 Agent 之间维护 Skills、MCP、插件和 Hooks 的个人开发者，用中心库统一分发并诊断配置。
- 需要在 Claude、Codex、Gemini、OpenCode 或 Hermes 供应商配置之间切换的用户，用 Agent Switch 测试连通性和延迟后切换。
- 在一台或多台服务器上运行编码 Agent 的远程开发者，通过 SSH 隧道把 Hook 事件带回同一个本地界面。
- 希望审查 Claude Code 请求细节的高级用户，手动启用网络监控并在本地 Inspector 中检查 prompt、messages、tools、response 和 Token 数据。
如何安装或部署这个 Agent？
macOS 推荐执行：brew tap shirenchuang/tap && brew install --cask agentbro。也可从 GitHub Releases 下载通用 DMG。Windows x64 可下载 AgentBro_latest_x64-setup.exe 或 AgentBro_latest_x64.msi；当前安装包未签名，可能触发 SmartScreen。普通桌面使用未说明需要账户或 API 凭据；SSH、Webhook 和外部 API 供应商功能需要用户自行提供相应连接配置。源码开发要求 macOS 或 Windows、Node.js 20+、pnpm、Rust toolchain、Cargo 和 Tauri CLI，然后执行：git clone https://github.com/shirenchuang/agentbro.git；cd agentbro；pnpm install；pnpm tauri:dev。
如何使用这个 Agent？
启动 AgentBro 后进入 Island -> Integration，先运行 Hook Doctor，再选择 Install All Hooks 或只为正在使用的 Agent 安装 Hook。重启对应 CLI 会话并启动 Claude Code、Codex、Gemini CLI 或其他受支持的 Agent，灵动岛随后显示会话状态、工具调用、权限、问题、计划和完成提醒。若需集中配置，进入 Agent管理 -> Agent 管理，选择 Agent 后使用 Hooks、Skills、MCP 或插件页面；MCP 工具调用前会显示参数和风险确认。远程使用时从 ~/.ssh/config 导入主机并建立 SSH 隧道。浏览器 UI 调试可运行 pnpm dev，然后访问 http://localhost:1423；设置面板位于 http://localhost:1423/#settings。
这个 Agent 有哪些优点和局限？
- 一个悬浮界面可聚合多个 Agent 的会话、审批、问题、工具调用、Subagent、Token 和完成状态，并支持直接处理部分交互。
- 管理范围不止会话监控，还覆盖 Agent 安装与路径、Hooks、集中式 Skills、可撤销 Skill Pack、MCP、插件和配置文件。
- 采用本地优先传输，会话事件和本地配置无需云端中转；网络访问集中在更新、市场下载、SSH、Webhook 等被主动使用的功能。
- 同时覆盖本地和 SSH 远程会话，并保留主机标识，适合区分多台机器上的任务。
- 支持多种编码 Agent 和多个 API 供应商配置，不把核心工作流绑定到单一模型提供方。
- Windows 版本仍处于早期 MVP，代码签名、SmartScreen 体验、自动更新和部分 Agent 的深度交互尚未完善。
- Linux 没有正式版本，也未进入当前发布计划。
- 各 Agent 的公开 Hook 能力不同，因此事件覆盖和可交互深度并不一致；Codex Desktop 的自由文本回复等少数能力在 Windows 上不可用。
- Claude Code 网络监控默认关闭，启用后才可检查请求内容；这类深度检查仅明确针对 Claude Code。
- 宠物市场依赖 Node.js 18+ 和 abpets CLI，属于额外运行时成本；从源码构建还需要完整的 Node、pnpm、Rust、Cargo 与平台工具链。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| AgentBro 当前 | 78 · 表现良好 | 桌面应用免费 | ★ 166 | 3 个月前 | Rust | Codex · Claude Code |
| OpenJarvis 本地个人 AI | 56 · 缺口较多 | 命令行工具免费 | ★ 13k | 1 天前 | Python | — |
| Synara | 52 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 2.2k | 今天 | TypeScript | Codex · Claude Code |
| Pi Agent Desktop | 52 · 缺口较多 | — | ★ 323 | 13 天前 | TypeScript | OpenAI API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
资料明确说明本地 Unix socket 或 TCP 传输、按功能触发的更新检查、下载、SSH 与 webhook，以及默认关闭的网络监控；CI 也仅授予 contents: read。权限审批快捷键默认关闭，MCP 工具调用前展示参数并进行风险确认，体现了较好的用户控制。扣分在于产品能够安装或删除 CLI、改写配置、安装 hooks、分发技能并访问远程主机，所给源码未完整展示各操作的权限边界与逐项确认流程；默认自动批准列表虽主要是低风险工具，但仍包含状态变更操作。敏感数据方面有本地优先、日志脱敏指导和不读取 Doubao 对话内容的声明，但未提供凭据存储、加密、日志保留或访问控制实现。依赖使用冻结安装和受限 CI 权限，但未见漏洞扫描、依赖更新策略或锁文件证据。技能撤销和 hook 修复提供有限恢复能力，尚无通用配置备份、事务回滚或失败恢复说明。来源、许可证和维护渠道清楚，但发布者身份未经企业注册验证，且资料没有进一步确立法律主体。
README、package 元数据、测试和 CI 对 React/Tauri 架构、Node 20、双平台构建及测试命令的描述相互一致；平台路径测试和默认交互设置测试也支持部分实现主张，因此自洽性充分。依赖与系统前置条件、安装命令和构建矩阵记录较完整，但仍依赖外部 agent、市场、SSH、webhook 和平台组件，资料未说明这些依赖不可用时的完整降级策略。Hook Doctor、连接诊断、连接日志、配置验证和构建失败检查表明有错误反馈设计，但没有提供足够的实际错误消息、恢复建议或错误分类实现来支持满分。
目标用户、并行会话、审批、配置管理、远程开发和多 agent 场景均有清晰说明。资料细分了 hook 集成、管理扫描和项目扫描范围，并明确不同 agent 的交互深度、Doubao 的推断限制、Windows MVP 状态及 Linux 不支持，能力边界尤其完整。触发方式包括显式安装 hooks、手动开启网络监控和按需使用外部服务，但没有展示全部事件匹配、去重、误触发抑制或 webhook 触发实现，因此触发精度扣分。macOS 与 Windows 的要求、路径差异、构建工具和限制说明充分，环境适配获得满分。
文档从安装、用途、能力、支持矩阵、路线图、平台、开发、贡献、发布到许可证组织清楚，并提供 Homebrew、DMG、EXE、MSI 和源码开发步骤。命名总体一致，但大量 agent 别名、两层支持范围和不断扩展的集成面增加稳定性风险，且没有兼容性承诺。演示、使用步骤和命令示例丰富，但缺少集中式 FAQ 和深入故障排除。Windows、Linux、Doubao、Codex Desktop 等限制均被具体披露。Apache-2.0 正文、package 元数据及品牌资产例外说明完整。版本 3.1.0、发布入口和 release 文档有记录，但所给资料没有实际变更日志。安全报告渠道、dev 分支和社区渠道表明有人维护，但未明确维护团队、响应时限、正式支持主体或长期更新承诺。
浮动审批、会话状态、工具时间线、差异、token 信息、统一 hooks、技能、MCP、插件和远程会话管理构成可直接使用的输出与工作流；截图说明、交互步骤和针对多会话的设计支持较高可用性。将分散在多个 agent 和终端中的管理与关注请求集中处理，具有明确的边际价值。扣分在成本收益：尽管本地优先且源码开放，仍需安装桌面常驻程序、hooks、Node/Rust 相关组件，并承担广泛本地配置与远程连接权限的运维和安全成本；Windows 仍为早期 MVP。
版本、依赖、构建命令、CI、平台路径和默认安全交互等部分主张可追溯到 package、工作流和测试；但多数广泛的集成与功能主张只出现在 README，缺少对应实现文件或专项测试，故追溯性未满分。README 与测试、CI、许可证元数据对若干事实形成交叉印证，但远程、市场、更新、MCP、插件和敏感数据行为没有多源佐证。资料清楚区分当前功能、可变覆盖范围、最佳努力推断、默认关闭功能、早期 MVP、缺失平台和未来路线图，事实与计划的分离较好。
- 该应用可安装或删除 agent、修改配置、安装 hooks、分发技能并连接远程主机；使用前应确认每类写操作的授权提示、目标路径和备份机制。
- 网络监控能够显示系统提示、消息、工具响应和 token 数据。即使默认关闭，启用前也应核实本地存储、日志保留、访问控制和删除方式。
- 资料未展示依赖漏洞扫描、锁文件内容或已知漏洞处置流程；发布安装包和第三方依赖仍需独立审查。
- Windows 版本是未签名的早期 MVP，可能触发 SmartScreen，缺少自动更新且部分交互不可用；Linux 没有官方构建。
- 远程 SSH、市场下载、更新检查和 webhook 会产生外部连接；应分别核实目的地、传输内容、凭据处理与禁用方式。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
AgentBro v3.1.0 English AgentBro v3.1.0 adds first-class Antigravity 2.0 support and turns shared Agent Skills into a clearer, safer, and faster part of Agent Management on both local and remote environments. Highlights - Antigravity 2.0 desktop and agy CLI support - AgentBro now detects Antigravity desktop and CLI installations, registers their official lifecycle and permission hooks, and manages their Skills, MCP servers, plugins, and hook paths while preserving user-owned configuration. Legacy AgentBro-managed hooks are migrated without rewriting unrelated settings. …在 GitHub 查看 ↗ -
发布说明摘录
AgentBro v3.0.0 English AgentBro v3.0.0 turns Agent Management into a unified local-and-remote control center. Choose a runtime environment once, then use the same Skill Library, installation, skill packs, Agent inspection, and diagnostics against that machine. Highlights - One runtime switcher for the whole workspace - Switch between the local Mac and configured SSH hosts from the lower-left environment control. Remote badges, connection state, and explicit connect actions remain visible throughout Agent Management, so every page makes its current target clear. …在 GitHub 查看 ↗ -
发布说明摘录
AgentBro v2.10.0 English AgentBro v2.10.0 turns Agent settings into a hands-on control center for plugins, MCP servers, configuration files, and local Skills. Highlights - Complete plugin control center - Discover installed plugins for Codex, Claude Code, WorkBuddy, ZCode, and Kimi; search and filter them, safely enable or disable supported plugins, inspect manifests and packaged capabilities, and preview Markdown, text, or image files without leaving AgentBro. …在 GitHub 查看 ↗