终端里的多个 AI Agent 越开越窄怎么办?gwae 把 macOS 工作区变成横向滚动条带
当 Claude Code、Codex 或其他终端 Agent 同时运行时,最先崩溃的往往不是模型,而是工作区:几个 pane 越分越窄,状态信息藏在屏幕边缘,想找一个等待确认的 Agent 还要逐个切换。gwae 的思路很直接:把终端 pane 从“不断压缩的网格”改成横向滚动的条带,让每个 pane 保持可读宽度。
它解决的不是另一个 Agent,而是终端编排
gwae 是一个面向 macOS 的终端复用器和 Agent 编排工具,项目用 Rust 编写,采用 MIT 许可证。它可以把多个命令行 Agent 放在同一个可横向浏览的工作区中,并提供一个悬浮信息面板,显示 pane 当前处于 Running、Idle 还是 Failed 状态。
这和 tmux 的定位不同:tmux 更像稳定、通用的会话管理层;gwae 更关注“同时盯着一队编码 Agent”这件事。项目 README 目前明确写的是 macOS 开发和测试,Linux 用户可以参考其文档中提到的 niri,但不要把它当成已经验证的跨平台安装方案。
安装与第一次启动
项目提供安装脚本,也提供 Homebrew 方式。为了让安装过程可审计,建议先阅读脚本内容;如果你接受直接执行官方脚本,可以运行:
curl -fsSL https://hongnoul.github.io/gwae/install.sh | bash
或者:
brew install hongnoul/tap/gwae
安装后,在 macOS 终端中启动:
gwae
首次使用最重要的是确认 Option 键被当作 Meta 键。按下 ⌥+/,如果能打开帮助面板,说明快捷键基础配置正常。若终端输入了特殊字符而不是触发快捷键,需要在 Terminal.app、iTerm2、Ghostty 或 WezTerm 中启用类似“Use Option as Meta Key”的选项。
用一条工作流熟悉核心操作
先按 ⌥+Enter 创建第二个 pane,再用 ⌥+h 和 ⌥+l 在 pane 之间移动。继续创建到六个 pane 时,传统网格通常会让每格越来越窄;gwae 会让视口向右滚动,同时尽量保持 pane 的宽度。
几个值得记住的操作如下:
| 操作 | 快捷键 | 用途 |
| — | — | — |
| 新建 pane | ⌥+Enter | 打开新的 shell pane |
| 移动焦点 | ⌥+h/j/k/l | 按方向切换 pane |
| 打开 Agent | ⌥+; | 使用已安装的 Agent harness |
| 选择 Agent | ⌥+Shift+; | 从列表中选择具体 Agent |
| 选择启动目录 | ⌥+d | 决定下一个 pane 的工作目录 |
| 调整宽度 | ⌥+r | 循环切换当前列宽度 |
| 保持唤醒 | ⌥+w | 切换 macOS caffeinate 状态 |
| 跳到需要关注的 pane | ⌥+g | 优先定位有失败或等待状态的 pane |
例如,你可以为前端、后端、测试和文档各开一个 Agent pane。日常巡视时按住 Option 查看状态面板,看到失败或需要输入的 pane 后按 ⌥+g 跳过去,而不是依赖记忆 pane 的位置。
让 Agent 参与操作,而不是只把它当 shell
gwae 支持选择 Agent harness,也支持在 pane 中直接运行命令。项目 README 给出的示例包括用 gwae run "claude" 启动 CLI。实际使用时,可以先在不同目录打开 pane,再分别启动不同任务:
gwae run "claude" cargo test --workspace
这里要注意:gwae run 的可用行为应以当前版本帮助信息和 Agent 指南为准;不要把它想象成一个自动替你分配任务的多 Agent 调度平台。它的价值首先是把终端空间、状态观察和启动入口整理好。
什么时候值得换成 gwae
如果你只需要一两个长期 shell 会话,tmux 可能已经足够。如果你经常同时运行多个 CLI 编码 Agent,且痛点是 pane 变成“细条”、等待确认难发现、需要不断横向查看工作区,那么 gwae 的滚动条带和状态 HUD 更贴近这个场景。
需要提前接受的限制也很明确:官方文档仍在完善,项目当前以 macOS 为开发和测试平台;它不是远程服务器上的通用复用器,也不会替你解决 Agent 权限、密钥泄露或代码审查问题。比较稳妥的组合是:用 gwae 管理本地可视工作区,用各 Agent 自己的审批机制和 Git 工作流控制风险。
结语
多 Agent 开发的瓶颈有时不是“再增加一个模型”,而是让人类能看清正在发生什么。gwae 用无限滚动的 pane 布局、Agent 状态概览和面向 CLI harness 的快捷操作,针对的正是这个操作层问题。如果你的终端已经被一排排 Agent 占满,可以先安装它,创建六个 pane,观察自己的注意力是否真的比 tmux 网格更容易保持在正确的位置。
相关链接