A macOS Dynamic Island for AI coding agents: Claude Code, Codex, Gemini CLI, Cursor, hooks, skills, and local agent management.
$ npx -y skills add shirenchuang/agentbro --agent claude-code
Run the curl in your terminal, the rest in Claude Code.
Repo: shirenchuang/agentbro
What's inside
| 平台 | 推荐安装方式 | 其他安装包 |
|---|---|---|
| macOS | brew tap shirenchuang/tap && brew install --cask agentbro | 通用 DMG · 国内镜像 |
| Windows x64 | 下载安装程序（EXE） | MSI |
安装后打开 Island -> Integration，先运行 Hook Doctor，再给正在使用的 Agent 安装 Hook。Windows 安装包目前属于早期 MVP；核心悬浮窗、Hook 传输、路径探测和 Agent 管理已经可用，未签名安装包可能触发 SmartScreen 提示。
AI 编程 Agent 已经能连续工作很久，但人仍要守着终端：等权限、回答问题、看任务有没有卡住，还要分别维护每个工具的 Hooks、Skills、MCP 和插件。AgentBro 把这些分散的操作放到一个桌面入口里。
| 你正在做的事 | AgentBro 提供的能力 |
|---|---|
| 同时跑多个 Agent 会话 | 灵动岛聚合状态、工具调用、Subagent、Token 和完成提醒。 |
| Agent 等待审批或输入 | 直接批准权限、回答问题、确认计划或快速回复，不必找回原终端。 |
| 维护多套 Agent 环境 | 扫描安装状态、版本、路径和 Hook，并集中管理 Skills、MCP、插件与配置文件。 |
| 切换模型或 API 供应商 | Agent Switch 管理 Claude、Codex、Gemini、OpenCode 和 Hermes 的供应商配置、测速与切换。 |
| 在服务器上跑 Agent | 通过 SSH 把远程会话和 Hook 事件带回本机，并在同一处诊断连接。 |
Agent 会话事件和本地配置不需要云端中转。Hook Server 默认监听当前用户的本地 Unix Socket，Windows 使用本地 TCP 端点；更新检查、市场下载、SSH 和 Webhook 只会在你使用相应功能时访问对应服务。
https://github.com/user-attachments/assets/df857822-ea0a-4745-a0b9-80f265f30dc6
https://github.com/user-attachments/assets/374d6e53-c126-41be-a593-4e5f63485602
Agent Monitor 汇总当前和历史会话，可以按项目查看运行阶段、工具时间线、审批、问题、对话与原始 Hook 事件。手动开启 Claude Code 网络监控后，还能在本地 Inspector 中检查 system prompt、messages、tools、response、Token 用量和 KV cache，并按模型与项目汇总统计。网络监控默认关闭。
除了灵动岛，AgentBro 还可以把浮窗切换成宠物状态面板。一只桌面宠物会跟随当前活跃的 Agent，它的活力会随上下文压力和 Token 用量实时变化，让你一眼看出会话是轻松还是吃紧。
宠物市场支持浏览和一键安装社区宠物，整个流程由 abpets CLI 驱动（Node.js v18+）。在设置面板的 Island -> 宠物市场 即可打开，也可以在网页上预览：
想自己创作宠物，可以使用 shirenchuang/agentbro-pet Skill：它会把角色概念、品牌线索或参考图生成 AgentBro 可用的 pet.json + spritesheet.webp 宠物包，并支持接入不同的生图后端。可通过 npx skills add https://github.com/shirenchuang/agentbro-pet.git 安装，也可以直接克隆；Codex、Claude Code、Cursor、Gemini CLI 等任意能运行脚本和生成图片的 Agent 都可以使用。
灵动岛目前内置午夜、AgentBro 经典、磨砂玻璃、苹果、烟灰、海雾、暖纸和柔薰衣草等主题，也可以跟随系统自动切换浅色与深色外观。
如果你同时在用 Claude Code、Codex、Gemini CLI、Cursor、Kimi、豆包、Qoder、OpenCode 等工具，Agent管理 可以把它们的安装、接入和本地配置收进同一个工作台。
Agent Switch 用来管理 Claude、Codex、Gemini、OpenCode 和 Hermes 的 API 供应商配置。你可以添加或复制供应商、切换当前配置、检测连通性与延迟，也可以从 CC Switch 预览并导入已有的供应商、MCP、Prompt 和 Skill 数据。
远程开发不需要再开一套监控界面。AgentBro 可以从 ~/.ssh/config 导入主机，通过 SSH 隧道接收远端 Hook 事件，并在本机查看远程会话、安装或修复 Hooks、运行诊断。连接信息和会话来源会保留主机标识，便于同时区分本地与多台服务器上的任务。
AgentBro 的支持分为两层。运行时 Hook 适配器负责把会话事件送进灵动岛；Agent 管理还会扫描更大范围的 CLI、桌面 App、Skills、MCP、插件和路径。各 Agent 公开的 Hook 能力不同，因此事件和交互深度会有差异。
| 范围 | Agent |
|---|---|
| 灵动岛 / Hook 接入 | Claude Code、Codex、Gemini CLI、Cursor / Cursor CLI、GitHub Copilot、Cline、Qoder / Qoder CLI、CodeBuddy / CodeBuddy CN、Qwen、Kimi、DeepSeek、OpenCode、Factory Droid、StepFun、AntiGravity、WorkBuddy、Hermes、Pi、Kiro、ZCode |
| Agent 管理扫描 | 上面所有 Agent，另支持豆包、.agents 共享目录、Junie、Windsurf、Augment、KiloCode、OB1、Amp、Aider、OpenClaw / QClaw / EasyClaw / AutoClaw，以及自定义 Agent |
| 项目级扫描 | 目前聚焦 Claude Code 与 Codex 常见项目配置：项目级 Skills、MCP、插件和指令文件 |
豆包 macOS 支持会检测 /Applications/Doubao.app、管理 ~/Doubao/skills，并继续通过中心库覆盖豆包兼容的 ~/.agents/skills。由于豆包目前没有公开 Hook，灵动岛中的任务状态来自本机进程与两个任务存储目录的只读元数据关联，不读取聊天内容；该状态属于尽力推断，页面同步可能造成短暂误报。
AgentBro 会继续坚持本地优先。接下来的重点包括：
如果你正在使用 AgentBro，或者想讨论 Windows 体验、更多 Agent 适配、Agent Monitor、Agent Switch 和 Skills 社区，可以扫码添加微信，备注 AgentBro 交流群，或直接扫码加入 AgentBro 开源社区 群聊。
macOS 与 Windows 都会随正式版本发布可下载产物：
| 平台 | 当前状态 | 发布形式 |
|---|---|---|
| macOS | 主要开发与签名发布平台，功能覆盖最完整 | Apple Silicon / Intel 通用 DMG、Homebrew Cask、应用内更新 |
| Windows x64 | 早期 MVP，悬浮窗、TCP Hook、Windows 路径探测、Agent 管理、Skills 和安装包已可用 | NSIS .exe、MSI |
| Linux | 暂无正式版本 | 尚未进入当前发布计划 |
Windows 仍在完善代码签名、SmartScreen 体验、自动更新和部分 Agent 的深度交互。Codex Desktop 的自由文本回复等少数能力会因 Windows 客户端接口限制而不可用，但不会影响会话观察和基础 Hook 交互。
cargo tauri --versiongit clone https://github.com/shirenchuang/agentbro.git
cd agentbro
pnpm install
pnpm tauri:dev
pnpm tauri:dev 会启动 http://localhost:1423 上的 Vite 开发服务，并打开 AgentBro 原生窗口。
pnpm dev
打开：
http://localhost:1423http://localhost:1423/#settings浏览器开发模式内置了 Claude Hook UI Lab，可以切换权限请求、计划审批、问题、完成提醒、紧凑模式、列表模式和详情模式等静态场景。
pnpm test:run # 运行测试
pnpm test # 监听模式运行测试
pnpm lint # ESLint
pnpm build # 类型检查并构建前端
cargo check --manifest-path src-tauri/Cargo.toml # 检查 Rust 后端
pnpm tauri:build # 构建 macOS app / DMG
pnpm tauri:build:windows # 构建 Windows NSIS / MSI
./build.sh # 构建通用 macOS DMG
之后 AgentBro 会在灵动岛中展示会话状态、工具调用、权限请求、问题、计划和完成提醒。
欢迎提交 Issue 和 Pull Request！
good first issue / help wantedPR 请提到 dev 分支，提交前跑一遍 pnpm lint && pnpm test:run && pnpm build && cargo check --manifest-path src-tauri/Cargo.toml。
发布说明和签名要求见 docs/release.md。
https://agentbro.oss-cn-hangzhou.aliyuncs.com/AgentBro_latest_universal.dmghttps://github.com/shirenchuang/agentbro/releasesAgentBro 代码基于 Apache License 2.0 开源。
AgentBro 名称、Logo、应用图标、官网视觉和其他品牌资产不随代码授权开放。修改版或分发版请使用不同名称，避免和官方项目产生混淆，并遵守 NOTICE 和 TRADEMARKS.md。
.agents/
skills/
agentbro-release/
SKILL.md
source-command-check/
SKILL.md
.claude/
CLAUDE.md
commands/
add-agent.md
check.md
rules/
evobase-rule.md
.github/
ISSUE_TEMPLATE/
agent_request.yml
bug_report.yml
config.yml
feature_request.yml
PULL_REQUEST_TEMPLATE.md
release-notes.md
workflows/
build.yml
ci.yml
close-linked-issues.yml
pr-policy.yml
release.yml
sync-release-to-dev.yml
.gitignore
AGENTS.md
ant_cc_test.json
build.sh
CODE_OF_CONDUCT.md
CONTRIBUTING.en.md
CONTRIBUTING.md
diagrams/
2026-06-02T092652/
architecture.json
architecture.png
architecture.svg
ui-mockup.json
ui-mockup.png
ui-mockup.svg
docs/
assets/
screenshots/
agent-management-agent-detail.png
agent-management-install-skills.png
agent-management-skill-library.png
agent-management-skill-packs.png
island-detail.png
island-expanded.png
island-permission.png
social-preview.png
brand/
agentbro/
assets/
app/
agentbro-app-icon.svg
logo/
agentbro-lockup-en.svg
agentbro-lockup-zh.svg
agentbro-mark-color.svg
agentbro-mark-mono.svg
raster/
agentbro-app-icon-reference.png
agentbro-lockup-en-reference.png
agentbro-lockup-zh-reference.png
agentbro-mark-reference.png
ink-amber/
agentbro-ink-amber-app-icon.png
agentbro-ink-amber-detail-board.png
agentbro-ink-amber-lockup-en.png
agentbro-ink-amber-lockup-zh.png
agentbro-ink-amber-mark-dark.png
agentbro-ink-amber-mark.png
agentbro-ink-amber-tray-showcase.png
tray/
agentbro-ink-amber-tray-attention.png
agentbro-ink-amber-tray-default-dark.png
agentbro-ink-amber-tray-default.png
agentbro-ink-amber-tray-error.png
agentbro-ink-amber-tray-paused.png
agentbro-ink-amber-tray-running.png
tray/
agentbro-tray-attention.png
agentbro-tray-default.png
agentbro-tray-error.png
agentbro-tray-paused.png
agentbro-tray-running.png
agentbro-tray-showcase.png
variants/
agentbro-01-teal-lockup.png
agentbro-01-teal-mark.png
agentbro-01-teal-tray.png
agentbro-02-amber-lockup.png
agentbro-02-amber-mark.png
agentbro-02-amber-tray.png
agentbro-03-green-lockup.png
agentbro-03-green-mark.png
agentbro-03-green-tray.png
agentbro-04-blue-lockup.png
agentbro-04-blue-mark.png
agentbro-04-blue-tray.png
agentbro-05-coral-lockup.png
agentbro-05-coral-mark.png
agentbro-05-coral-tray.png
agentbro-06-mono-lockup.png
agentbro-06-mono-mark.png
agentbro-06-mono-tray.png
agentbro-color-systems-board.png
agentbro-tray-variants-board.png
tokens/
agentbro-brand.css
tray/
agentbro-tray-attention.svg
agentbro-tray-default.svg
agentbro-tray-error.svg
agentbro-tray-paused.svg
agentbro-tray-running.svg
exports/
png/
agentbro-app-icon.png
agentbro-color-systems-board.png
agentbro-ink-amber-app-icon.png
agentbro-ink-amber-detail-board.png
agentbro-ink-amber-lockup-en.png
agentbro-ink-amber-lockup-zh.png
agentbro-ink-amber-mark.png
agentbro-ink-amber-tray-attention.png
agentbro-ink-amber-tray-default.png
agentbro-ink-amber-tray-error.png
agentbro-ink-amber-tray-paused.png
agentbro-ink-amber-tray-running.png
agentbro-ink-amber-tray-showcase.png
agentbro-lockup-en.png
agentbro-lockup-zh.png
agentbro-mark-color.png
agentbro-mark-mono.png
agentbro-tray-attention.png
agentbro-tray-default.png
agentbro-tray-error.png
agentbro-tray-paused.png
agentbro-tray-running.png
agentbro-tray-showcase.png
agentbro-tray-variants-board.png
previews/
brand-board.html
README.md
references/
color-exploration-board.png
design-demos/
agent-skill-manager-demo.html
agentbro-skill-manager-v2-demo.html
generated/
agentbro-docs/
GLM-5.1/
01-overview.md
02-architecture.md
03-data-flow.md
04-skill-management.md
05-code-review.md
06-contributor-guide.md
07-evidence-map.md
opencode-adapter-gap.md
plans/
2026-05-28-homebrew-telemetry-design.md
2026-05-29-agentbro-capability-batch-1-design.md
2026-06-03-windows-porting-progress.md
2026-06-09-windows-release-artifacts-design.md
2026-06-13-skill-manager-v2-acceptance-criteria.md
2026-06-13-skill-manager-v2-handoff.md
2026-06-13-skill-manager-v2-product-requirements.md
2026-06-13-skill-manager-v2-technical-design.md
2026-07-23-mcp-capability-inspector-design.md
2026-07-23-mcp-editor-visual-refinement-design.md
2026-07-23-mcp-management-design.md
2026-07-28-antigravity-2-design.md
2026-07-28-antigravity-2-implementation.md
2026-07-29-zcode-inherited-shared-skills-design.md
2026-07-30-shared-skill-consumers-design.md
privacy-policy.md
release.md
superpowers/
plans/
2026-06-18-agent-sync-redesign.md
2026-06-19-local-symlink-import.md
2026-08-03-agent-skill-delete-performance.md
specs/
2026-06-18-agent-sync-redesign-design.md
2026-07-31-layered-agent-skill-scopes-design.md
2026-08-03-agent-skill-delete-performance-design.md
2026-08-03-shared-agent-skill-control-reuse-design.md
telemetry.md
eslint.config.js
homebrew/
Casks/
agentbro.rb
index.html
LICENSE
NOTICE
package.json
pnpm-lock.yaml
public/
agentbro-app-icon.png
agentbro-group-qr.png
agentbro-logo-dark.png
agentbro-logo.png
agentbro-tray-icon-dark.png
agentbro-tray-icon.png
agentbro-wechat-qr.jpg
favicon.png
favicon.svg
icons.svg
qa-state-tests.py
README.en.md
README.md
scripts/
build-bridge.mjs
build-windows.mjs
check-release-readiness.mjs
create-updater-manifest.mjs
skillManagerCss.test.mjs
SECURITY.md
skills/
agentbro-pr-merge/
SKILL.md
src/
src-tauri/
build.rs
capabilities/
default.json
Cargo.lock
Cargo.toml
Entitlements.plist
gen/
schemas/
acl-manifests.json
capabilities.json
desktop-schema.json
macOS-schema.json
windows-schema.json
icons/
128x128.png
128x128@2x.png
32x32.png
icon.icns
icon.ico
icon.png
icon.svg
tray-ink-amber.png
src/
agents/
antigravity.rs
claude_code.rs
cline.rs
codebuddy.rs
codebuddycn.rs
codex_app_server.rs
codex.rs
copilot.rs
cursor_cli.rs
cursor.rs
deepseek.rs
detection.rs
droid.rs
executable.rs
gemini.rs
hermes.rs
hook_manager.rs
kimi.rs
kiro.rs
mod.rs
opencode.rs
pi.rs
profiles.rs
programs.rs
qoder_cli.rs
qoder.rs
qwen.rs
stepfun.rs
toml_hooks.rs
traits.rs
workbuddy.rs
zcode.rs
bridge/
main.rs
commands/
buddy.rs
mod.rs
monitor.rs
persistence.rs
config/
mod.rs
data_dir.rs
energy.rs
hook_endpoint.rs
hooks/
claude_desktop_watcher.rs
conversation_parser.rs
diagnostics.rs
doubao_watcher.rs
file_watcher.rs
mod.rs
recovery.rs
server.rs
session_store.rs
tool_processor.rs
lib.rs
main.rs
market/
mod.rs
menu_bar.rs
network_monitor.rs
pets/
mod.rs
platform/
display_controller.rs
display.rs
idle.rs
mod.rs
monitor_tracker.rs
notifications.rs
process.rs
remote/
attach.rs
installer.rs
manager.rs
mod.rs
path.rs
skill_manager.py
skill_manager.rs
ssh_config.rs
ssh_tunnel.rs
terminal.rs
skills/
agent_paths.rs
codex_config.rs
config_file_editor.rs
explanation.rs
frontmatter.rs
installer.rs
marketplace.rs
mcp_management.rs
mod.rs
plugin_management.rs
registry.rs
scanner.rs
sync.rs
v2/
agent_meta.rs
commands.rs
db.rs
diagnosis.rs
fsutil.rs
mod.rs
models.rs
service.rs
snapshot.rs
tests.rs
zcode_config.rs
sound/
assets/
hey-bro.wav
mod.rs
switch/
app_type.rs
commands.rs
db.rs
deeplink.rs
health.rs
live_writer.rs
migration.rs
mod.rs
presets.rs
pricing.rs
prompts.rs
providers.rs
schema.rs
usage.rs
telemetry.rs
terminal/
approval.rs
jump.rs
mod.rs
process_tree.rs
registry.rs
suppression.rs
tmux.rs
wave.rs
theme/
mod.rs
scanner.rs
webhook/
forwarder.rs
mod.rs
templates.rs
tauri.conf.json
App.css
App.tsx
... 354 moreFetches web pages, including JS-rendered and WeChat articles, and returns clean Markdown via Jina Reader. Activates when extracting article content or converting URLs to Markdown for LLM workflows.
@shirenchuangFAQ
agentbro is a Claude Code plugin with 1 hand-picked skill for development work, indexed on Flowy. Install it with the command on its page. It includes agentbro-pr-merge. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.