
XControl 发布:基于 tmux 管理多个 CLI 代理会话并支持代理互发消息
来源标题:Show HN: XControl – tmux groups for agents with dir sessions and peer messaging
XControl 是一个基于 tmux 的轻量封装工具,可打开并恢复 Codex、Copilot、Claude 等 CLI 代理会话,并让代理之间互相通信。用户只需在一个 .agents 文件中定义文件夹和代理,即可打开项目,并在同一分组中混用不同 CLI 代理。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
一个围绕 tmux 的小型封装工具,用于打开并恢复你的 CLI agent 会话,支持 Codex、Copilot 和 Claude,并让 agent 之间能够互相通信。在一个 .agents 文件中定义文件夹和 agent,然后打开项目即可: 这是一次真实的 tmux 截屏,使用 myapp 文件夹和三个 Codex 会话。示例提示词已输入但尚未提交。你可以在同一个组里混用不同的 CLI agent,如下所示。 我最初是在不同项目之间手动运行和编排多个 agent。我自定义的 tmux 脚本效果不错,我觉得它们对别人可能也有用。xcontrol 就是从这些脚本中发展出来的,这样我就能把同样的工作流分享给社区。 这个工作流已经有流行的工具,包括 T3 Code、Herdr 和 Vibe Kanban。Zellij 和 WezTerm 这样的终端工作区也被广泛使用。相关工具一节列出了这些以及其他成熟选项。 如果你已经安装了 tmux,尤其是如果你一直用它来运行 agent,那么 xcontrol 就在这套设置上加了一个小巧的可复用封装。它会在平铺窗格中打开你的项目文件夹,恢复 CLI 会话,并让 agent 能够按角色找到彼此并互相发消息。你继续使用你熟悉的 tmux 和 agent CLI。 不需要额外的服务、模型 API 集成,也不需要安装 Python 包。一个 .agents 文件描述你的项目,xc 负责处理 tmux 命令。 需要 Linux 或 WSL2、Python 3.11+、tmux,以及已安装并完成认证的配置好的 CLI。已用 Codex 0.167.0、Copilot 1.0.103 和 tmux 3.4 测试。通过 Python 标准库使用 Linux flock。 git clone https://github.com/faustinoaq/xcontrol.git cd xcontrol ./install.sh 将 xc 和 xcontrol 安装到 ~/.local/bin,并将附带的 skill 安装到 ~/.codex/skills/xcontrol。请确保 ~/.local/bin 在你的 PATH 中。无需 sudo。这些命令是指向此 checkout 的符号链接;请保持 checkout 原地不动。 将 myapp.agents 保存在项目文件夹旁边: workspace/ ├── myapp.agents ├── myapp-android/ ├── myapp-ios/ └── myapp-server/ name = "myapp" [[agents]] id = "android" folder = "./myapp-android" agent = "codex" role = "Android app; coordinate API contracts with server." [[agents]] id = "ios" folder = "./myapp-ios" agent = "copilot" role = "Native iOS app; coordinate API contracts with server." [[agents]] id = "server" folder = "./myapp-server" agent = "codex" role = "Backend services and shared APIs; coordinate changes with android and ios." 文件夹相对于 .agents 文件解析,而不是相对于你的终端目录。绝对路径和 ~ 也可以使用。每个 agent 都有唯一的 ID、自己的工作目录、CLI 可执行文件名称,以及可选的 role 和参数列表。平铺布局最多可容纳 16 个 agent;终端大小限制了实际可用的数量。 可选的 resume = "auto" 是默认值:Codex 会使用只读的本地 SQLite 元数据,为该确切目录恢复其最新的未归档交互式 CLI 线程。Claude 在该目录中使用其原生的 --continue。Copilot 使用稳定的、特定于工作区的原生 --session-id,创建或恢复其 xcontrol 对话,而不会选择一个不相关的全局会话。resume = "new" 则从头开始;一个会话 UUID 会恢复一个明确的原生对话。历史记录不会在 CLI 之间转换。如果 Codex 的元数据不可用,它会从头开始并给出警告。 CLI 继承你正常的权限、模型和认证。不会添加任何权限绕过选项。角色会打印在每个窗格中;它们不会自动作为提示词发送。agent 字段指定 PATH 上的一个可执行文件,可选参数会作为字面参数传递。xcontrol 不会求值 shell 语法。请使用你信任的配置文件:启动 agent 会以你的正常账户权限运行该可执行文件。 使用 agent = "auto" 在打开新组时选择第一个已安装且模型访问可用的候选: name = "myapp" [[agents]] id = "server" folder = "./myapp-server" agent = "auto" candidates = ["codex", "copilot", "claude"] role = "Backend services and shared APIs." 默认候选顺序是 Codex、Copilot,然后是 Claude。缺失和失败的候选会被跳过。如果没有任何候选确认访问可用,xcontrol 不会打开任何窗格。xc availability myapp.agents 会运行相同的检查;它会发起少量模型调用。xc check 仅验证配置,不发起任何调用。 对于 Codex、Copilot 和 Claude,xcontrol 会通过 codex exec、copilot -p 或 claude -p 发送一个极小的提示词,要求返回 XCONTROL_OK。它要求既成功退出,又得到实际的模型回答。失败的探测会重试一次,包括可能是暂时性的授权失败。结果在每次启动时按 provider 缓存,因此多个窗格不会重复相同的检查。每次尝试有 30 秒超时。重新连接不会发起任何调用。 探测在临时目录中运行,位于你的项目文件夹之外,不会恢复你的工作对话。探测时 Claude 和 Copilot 的工具被禁用;Codex 使用其只读沙箱。已安装的 CLI 配置受信任,包括任何用户配置的集成。这些检查会消耗少量用量,并可能根据你现有的 provider 计费设置产生费用。它们使用 CLI 的默认模型选择,不会强制使用高级模型或更改计费设置。成功的探测仅确认那一刻的访问可用,不代表剩余配额多少或对所有模型的访问。检查失败只会在此次启动中跳过该 provider;它不会诊断永久性的订阅问题。 其他 CLI 可以在 [availability] 中使用受信任的自定义检查器,这也会覆盖内置探测: [availability] devin = ["my-access-check", "devin"]
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。