Skip to main content
Glama

Agent Hub

A local Codex plugin and MCP server for Antigravity, DeepSeek Harness (DSH), Claude Code, and OpenCode.

持久任务、实时公开事件、文件变更、会话续聊、进程树取消,以及可配置的执行权限。当前版本:0.2.0 Preview。仓库根目录附带 .agents/plugins/marketplace.json 本地插件市场描述。当前发布目标为 Windows;其他系统尚未完成端到端验收。

安装

需要 Python 3.11+,以及至少一个已经安装并登录的后端 CLI。

python install.py --register-codex --root "C:\Projects"

也可以双击 Install-Agent-Hub.cmd 安装运行环境,再使用上面的命令注册。脚本创建本项目的 .venv、安装依赖、生成本机 .mcp.json,保留 Codex 配置中的其他服务。之后重新加载 Codex,并双击 Start-Agent-Hub.cmd 打开工作台。

CLI 不在 PATH 时可以显式指定:

python install.py --register-codex --root "C:\Projects" --agy-exe "D:\Tools\agy.exe" --claude-exe "D:\Tools\claude.exe"

支持 --opencode-exe、--dsh-exe;重复 --root 可设置多个允许的任务目录。代理只在显式传入 --proxy 时写入本地配置,不硬编码代理端口。默认复用 CLI 已有登录、供应商和环境配置;本项目不附带账号或供应商密钥。

插件展示与技能位于 .codex-plugin/plugin.json、skills/;后台服务位于本仓库。将根目录作为本地插件源时,先运行安装脚本生成该电脑的 MCP 配置。若宿主同时加载插件内 MCP 与全局 MCP,只保留一个 local_agents 注册以免工具重复。脚本注册是可独立使用的完整 MCP 安装方式;不同 Codex 版本的插件导入 UI 仍需用户环境确认。

Related MCP server: synco-mcp

权限设置

默认 最大权限(full),按操作者选择执行。工作台右上角 权限设置 可修改全局和各后端默认值;创建任务时也可以单独覆盖。

后端

full

native

Antigravity

CLI 跳过工具审批

遵循 CLI 配置;无头模式拒绝后可在面板批准继续本任务

DSH

通过 ACP 原生权限选项自动授权

请求通过工作台传回原 worker

Claude Code

CLI 跳过工具审批

遵循 CLI 配置;无头审批被拒时需调整设置后续聊

OpenCode

仅为该进程注入允许工具的配置

保留既有 CLI 权限配置,支持工作台审批

权限在任务提交时保存。运行中的任务保留原权限,后续轮次使用当前设置。native 不是固定只读模式,其权限由后端自己的配置决定。full 不授予 Windows 管理员权限,也不突破 OS 或上游供应商限制。

Antigravity 的无头 CLI 没有原生单工具批准管道:面板明确标记“批准并继续本任务”,批准后允许该任务剩余步骤。Claude Code 当前没有面板到原 worker 的审批回复管道,不能将它的拒绝描述为可直接单击恢复。

后端

ID

默认模型

调用方式

antigravity

gemini-3.8-flash-high

agy stream-json

deepseek-harness

从当前已配置路由选择

桌面版捆绑 CLI 的 ACP

claude-code

sonnet

Claude Code CLI stream-json

opencode

banban/deepseek-v4.1-flash

OpenCode 本机服务/SSE

DSH 优先选取当前桌面默认路由(若可解析),否则选取已配置的 DeepSeek 路由;可通过模型字段或 DSH_MODEL 覆盖。OpenCode 当前电脑实测存在旧数据库缺表及供应商令牌失效问题,详见 VALIDATION.md;更换测试数据目录可以设置 AGENT_HUB_OPENCODE_DATA,不会自动迁移旧数据库。默认模型不保证账号额度及上游可用性;模型字段可以覆盖。DSH 使用原桌面配置中的模型路由及凭据引用。只检测到可执行文件不代表已登录。Claude Code npm 包、原生安装均可探测,亦支持 CLAUDE_EXE。

使用

通过 Codex 调用 hub_backends,再用 task_submit 提交目标、工作目录和验收标准。用 task_wait 等待、task_result 读取结果、task_artifacts 查看文件变更,最后独立验收。task_followup 续接会话;正在执行时会排队,不能中途强插模型轮次。hub_settings 读取默认权限,hub_dashboard 打开面板。

独立后台服务不会因为 MCP 断开而结束;机器或服务重启后保留历史,旧进程无法原地恢复,任务标记中断。最多两个并行 worker,重叠目录串行。取消会结束进程树,已发生的文件修改保留。

任务根目录白名单仅限制提交目录,不是 OS 文件沙箱。产物根据执行前后快照计算;并发人工修改也可能进入差异,不构成作者归属证明。公开流不转发隐藏思考。

验证

.venv\Scripts\python.exe -m unittest discover -s tests -v
.venv\Scripts\python.exe verify_protocol.py
.venv\Scripts\python.exe tools\release_check.py

离线测试不调用模型。协议检查会连接/启动本地服务,但不发起模型任务。真实账号验收会使用额度,应独立执行:

.venv\Scripts\python.exe tools\smoke_backends.py --backend antigravity --backend deepseek-harness --backend claude-code --root "C:\Projects\hub-smoke" --report ".state\smoke.json"

它检查创建文件、会话 ID、续聊追加及文件内容。实测范围见 VALIDATION.md。

数据与卸载

.state 保存任务数据库、服务令牌和日志;local-config.json、.mcp.json 保存该电脑的路径配置。它们都被 Git 忽略。不要把整个目录直接压缩发布;使用 tools/package_release.py 从 Git 文件清单生成发布包。

.venv\Scripts\python.exe install.py --unregister-codex

卸载只移除该 checkout 拥有的全局 MCP 注册,保留任务历史。请先结束运行任务并停止服务,再删除运行环境。迁移历史可以用 --state "已有状态目录"。安装脚本在私有 .state 中保存被替换的注册/配置备份,备份不可进入发布包。

许可证:MIT。后端 CLI 和模型服务分别遵循各自许可及条款,仓库不分发这些二进制或凭据。

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables multiple AI coding agents to coordinate on a shared software project by registering, claiming tasks, declaring file intents, publishing structured change reports, and handing off context, with a local dashboard showing state in near real time.
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Enables MCP-compatible clients to delegate complex multi-step programming and research goals to coordinated teams of specialized subagents, with cross-session messaging, swarm and pipeline workflows, sandboxed workspace tools, persistent SQLite state, and a live dashboard.
      22
      74 npm
      1
      MIT