Gg Agentic Harness

GG代理线束

从GGV3中提取的便携式代理线束。

包含

• packages/gg-core 目录/核心分辨率实用程序
• packages/gg-cli 操作员+自动化CLI(gg)
• mcp-servers/gg-skills 用于技能/工作流程的MCP服务器
• apps/macos-control-surface 从旧版GGAS仓库导入的本机macOS控制界面和查看器
• .agent 技能/工作流程/规则/模板以及角色文件和注册表
• 利用脚本运行工件、角色路由、运行时奇偶校验、反馈循环、上下文生成和黑曜石日志

macOS控制界面

该线束现在在以下位置承载了一个原生SwiftUI macOS应用程序 apps/macos-control-surface.

无头控制平面：

npm run control-plane:build
npm run control-plane:start

构建它：

npm run macos:control-surface:build

运行它：

npm run macos:control-surface:run

当前范围：

• 该工具现在公开了一个本地无头控制平面服务器，位于 packages/gg-control-plane-server
• macOS应用程序是同一HTTP控制平面上的可选客户端
• 协调器运行时选择为 Auto 默认情况下，显式 Codex, Claude，以及 Kimi 调度界面中可用的固定
• 集群控制、运行/总线状态、工作树浏览和硬件控制的排队都连接到线束本地服务器中
• 子代理在以下情况下获得专用工作树 .agent/control-plane/worktrees//
• Kimi仍受线束控制：它可以请求委派，但线束拥有生成/终止策略

架构图

• 图表来源： docs/architecture/agentic-harness-logic-loops-diagram.html
• 实时HTML预览： 打开渲染图
• 外部集成图来源： docs/体系结构/代理-外部集成-体系结构.md
• 外部集成图来源： docs/architecture/agentic-harnees-external integration-digram.html
• 外部集成实时预览： 打开渲染的集成图

优先整合浪潮（当前计划）

• PRD更新： docs/prd/prd-GG-CLI-PORTABLE-HARNESS.md
• 行动计划： docs/plans/2026-03-08优先级集成-行动计划.md
• 建筑合同： docs/体系结构/代理-外部集成-体系结构.md
• 附加组件评估： docs/评估/2026-03-08-网络评估.md

安装

git clone https://github.com/Geargrindadmin/gg-agentic-harness.git
cd gg-agentic-harness
npm install
npm run build
uv tool install --python python3.13 codegraphcontext
npm run harness:runtime:activate

笔记：

• CodeGraphContext 是可选的，但实时图形支持的上下文需要主机 cgc CLI。
• 此计算机上已验证的安装路径： uv tool install --python python3.13 codegraphcontext.
• 使用Python 3.10+ 至少。在macOS上，更喜欢Python 3.12+ 所以 CodeGraphContext 可以干净地使用其默认的本地数据库路径。
• 之后重新启动Codex npm run harness:runtime:activate 因此，回购范围的MCP更改被加载到活动会话中。
• 协调员 Auto 优先选择经过身份验证的本地CLI，然后使用提供商支持的回退 GG_COORDINATOR_PREFERENCE=codex,claude,kimi 除非被推翻。

远程安装到项目中（一个命令）

bash ` 硬固定无头/服务器启动的协调器。
1. 否则，线束将使用 `GG_COORDINATOR_PREFERENCE`，默认值 `codex,claude,kimi`.
1. 该线束更喜欢具有经过身份验证的本地CLI会话的运行时。
1. 如果没有可用的本地CLI会话，它将回退到支持的经过身份验证的提供程序凭据。
1. 无论选择何种协调器，子代理都将保持线束管理。

身份验证发现顺序：

- `codex`: `~/.codex/auth.json` -> `OPENAI_API_KEY`
- `claude`: `~/.claude/.credentials.json` -> `~/.local/share/opencode/auth.json` -> `ANTHROPIC_API_KEY`
- `kimi`: `~/.kimi/credentials/kimi-code.json` -> `~/.kimi/config.toml` -> `MOONSHOT_API_KEY|KIMI_API_KEY`