用途：Prowl CLI 用于检查或控制正在运行的 Prowl GUI 应用及其托管的智能体会话。仅当任务确为读取窗格、查看同级智能体、聚焦窗格、在 Prowl 中打开仓库或路径、发送文本、发送按键、创建或关闭窗格与标签页时才使用，不应仅因当前 shell 位于 Prowl 仓库内就使用。
主要能力：列出所有窗格（worktree→tab→pane）与检测到的智能体状态；读取窗格内容；向指定窗格发送文本或按键；聚焦窗格；创建新窗格或标签页；关闭窗格或标签页；通过 agents signal 上报事件；通过 create pane 配合 Profile 启动审查者并经 agents wait/dispatch 获取回执；通过 workflow 运行工作流包、交付输出与查询状态。
使用方式：权威逐命令参考为 Prowl 手册的 components/cli.md（源码检出时在 docs/，否则在应用包内，通常为 /Applications/Prowl.app/Contents/Resources/docs）。可用 prowl_docs="$(dirname "$(dirname "$(readlink -f "$(command -v prowl)")")")/docs" 定位。技能随应用分发：prowl skills install prowl-cli 会链接到各已检测的智能体技能目录，可加 --target <claude|codex|agents|devin|antigravity> 指定；prowl skills list 查看状态，该命令为本地操作、无需运行中的应用。常见做法：先经身份守卫确定自身窗格，再对具体 pane 执行 read/send/key/focus/close，命令如 prowl list --json、prowl agents --json、prowl read --pane "$pane" --last 80 --wait-stable --json、prowl send --pane "$pane" 'git status --short' --capture --timeout 30 --json。JSON 输出统一为 {ok, command, schema_version, data}，失败为 ok:false 加 error。
适用场景：并行运行多个编码智能体时进行编排、监视、聚焦与信息传递，以及启动带 Profile 的审查者、复用同一审查者多轮审查、运行工作流包。
限制：仅控制运行中的 Prowl GUI 应用，不能单独当作通用终端工具；PROWL_PANE_ID 等环境变量是继承而非验证值，经 sudo/ssh/容器或在 tmux/screen 及分离包装器下可能缺失或指向错误窗格；Codex 0.157+ 下不应信任 PROWL_PANE_ID，应改用 prowl list --json 的 .data.caller。若非进程祖先直达该窗格 shell，应停止而非猜测。窗格 UUID 与句柄不可跨应用重启缓存。agents dispatch 要求目标检测智能体处于 idle，否则以 DISPATCH_TARGET_BUSY 拒绝；同一窗格最多一个待处理 dispatch。--prompt - 需要管道或 heredoc，不可交互式 stdin；无 --profile 时没有 --background，分割窗格总会抢焦点。create pane 的方向需为 right/left/up/down。解析错误（错误标志）即便加 --json 也输出纯文本，需先检查退出码。其余细节以应用内文档为准。