Prowl：macOS AI Agent 指挥中心

项目简介

Prowl 是一款原生 macOS 应用，为同时运行多个 AI 编程 Agent 提供一个统一的指挥中心。当你在一个分支跑 Claude Code、另一个分支跑 Codex、第三个 Agent 处理迁移任务时，难点不是启动它们，而是知道下一个该看谁。Prowl 围绕这件事设计：把每个 worktree、标签页、分屏里的 Agent 集中呈现，并标出哪个被阻塞、哪个已完成。

主要功能

• Canvas：每个打开的标签页变成可缩放画布上的一张卡片，卡片本身是实时、可交互的终端，而不是缩略图。用 ⌘-click 多选后可向所有选中 Agent 广播同一段输入；任务完成的卡片标题栏会变橙，直到你查看为止。⌘⌥T 铺满窗口，⌘⌥R 收纳卡片，⌘⌥G 重置为均匀网格，⌘⌥↩ 切换 Canvas。
• Shelf：每个 worktree 成为一根书脊，按所属仓库的颜色排列，下方显示标签页与各 Agent 的状态标记。⌘⌃← / ⌘⌃→ 翻书，⌘⌃↑ / ⌘⌃↓ 切换标签，⌘⇧↩ 切换 Shelf。
• Agent Island：把 Agent 名册放在屏幕顶部，其他应用在前台时依然可见；在带刘海的 Mac 上环绕摄像头，其他显示器上浮在菜单栏。按 blocked、done、working、idle 的顺序计数，被阻塞和已完成的格子会从栏下方弹出，点击即跳到对应窗格。
• Active Agents：把所有 worktree、标签、分屏中的 Agent 汇总成一个列表，点击行即可进入该 Agent 的窗格，用 ⌥⌃↑ / ⌥⌃↓ 循环切换。Agent 完成或停下来询问时会发送 macOS 通知，⌘⌥U 跳到最近的未读窗格。
• Remote Projects：通过普通 SSH 打开远端机器上的项目，与本地仓库并列显示在侧边栏，其标签、分屏、脚本和 Agent 都运行在远端。使用你自己的 ssh 和 ~/.ssh/config（别名、跳板机、SSH agent 密钥），不在主机上安装任何东西，也不修改其启动文件。重启后标签与分屏会按原位置重连。
• 远端 Agent 检测：直接在窗格里 ssh devbox 后再启动 Agent，Prowl 也能识别其状态并标注主机名，还能跟随 tmux 客户端读取活动窗格。首次连接前会先询问是否启用检测。
• Agent Profiles：命名好的启动预设，包含运行时、模型、推理强度、执行模式与窗格打开位置，可单独设置环境变量（不出现在输入的命令和 shell 历史中）或独立的 runtime home。可从工具栏 Agents 菜单、⌘P → Launch Agent 或 prowl create tab --profile 启动。
• prowl CLI：让 Agent 自己读取窗格、执行命令、启动辅助 Agent。

已适配的 Agent 包括 Claude Code、Codex、Gemini CLI、Cursor Agent、Cline、OpenCode、GitHub Copilot、Kimi、Droid、Amp、Qoder CLI、Qwen Code、Grok Build、Pi、Oh My Pi 等。

安装与使用

从 Releases 下载 Prowl.dmg，或使用 Homebrew 安装：

brew install --cask onevcat/tap/prowl

首次启动后，工具栏的 Agents 菜单会根据本机已安装的 Agent CLI 自动生成启动项；也可以用 ⌘P 打开命令面板选择 Launch Agent。详细说明见官网手册：https://prowl.onev.cat/manual/ ，功能演示见 https://www.youtube.com/watch?v=4GYlXPttwi0 。

注意事项

• 目前仅支持 macOS。
• 远端项目的登录依赖 SSH 配置或 agent 中的密钥，尚不支持需要密码或验证码的主机；主机不可达时不会影响本地布局。
• Agent Island 默认关闭，需要在 Settings → Agents → Display 中开启。

本作品整理自 GitHub 开源项目 onevcat/Prowl，原作者 @onevcat。中文介绍由 AI 根据项目 README 整理，以原仓库为准。