AI 驱动的多终端任务编排平台，支持跨 CLI 多 Agent 协作、自动 Git 分支管理和复杂任务闭环执行

GitCortex 项目详情#

项目定位#

GitCortex 是一个 AI 驱动的多终端任务编排平台，支持跨 CLI 多 Agent 协作、自动 Git 分支管理和复杂任务闭环执行。

解决的核心问题#

AI 编程工作流中，跨多个 CLI 工具（Claude Code、Gemini CLI、Codex 等）进行协作时，面临任务编排困难、进度难以追踪、分支管理混乱、结果合并复杂等挑战。GitCortex 通过统一的 Orchestrator（Main Agent）协调多个 Terminal 执行单元，实现可监控、可回放、可恢复的闭环任务管理。

能力边界#

支持范围：多种 AI CLI 工具（Claude Code、Gemini CLI、Codex、Amp、Cursor Agent、Qwen Code、GitHub Copilot、Droid、Opencode）
数据模型：三层完整持久化（Workflow → WorkflowTask → Terminal）
执行模式：多 Task 并行，Task 内 Terminal 串行
事件机制：基于 Git commits 和 message bus 事件驱动，非轮询

核心能力与特性#

任务编排与调度#

特性	说明
Main Agent 协调	AI 驱动的中央控制器，负责任务分发、进度监控、结果审查
多任务并行	多个 Task 同时执行，每个 Task 拥有独立 Git 分支
Task 内串行执行	Terminal 按顺序执行（coding → review → fix）
事件驱动	基于 Git commits 和 message bus 事件推进，减少轮询

Git 集成#

特性	说明
自动分支管理	每个 Task 对应一个独立 Git 分支
Merge 管理	Global Merge Terminal 统一合并到目标分支
GitWatcher 服务	监控 .git/refs/heads 变化，触发事件

CLI 与模型支持#

特性	说明
多 CLI 支持	Claude Code、Gemini CLI、Codex、Amp、Cursor Agent、Qwen Code、GitHub Copilot、Droid、Opencode
cc-switch 集成	一键切换任意 CLI 的模型配置
多模型支持	Claude、Gemini、OpenAI 等

工作流管理#

特性	说明
Workflow 持久化	三层数据模型完整存储
Terminal Debug View	原生终端访问，用于环境配置验证
Slash Command System	可复用的 prompt 预设，支持模板变量替换

架构设计#

架构图#

╔═══════════════════════════════════════════════════════════════════╗
║                     Orchestrator (Main Agent)                      ║
║      User Config: API Type + Base URL + API Key + Model           ║
╚═══════════════════════════════════════════════════════════════════╝
         │                      │                      │
         ▼                      ▼                      ▼
  ┌─────────────┐       ┌─────────────┐       ┌─────────────┐
  │   Task 1    │       │   Task 2    │       │   Task 3    │
  │ branch:login│       │ branch:i18n │       │ branch:theme│
  └─────────────┘       └─────────────┘       └─────────────┘
                              │
                              ▼
                    [ Global Merge Terminal ]
                              │
                              ▼
                          [ main ]

核心服务模块#

服务	职责
OrchestratorAgent	Main Agent，负责任务分发、进度监控、结果审查
MessageBus	跨终端消息路由
TerminalLauncher	Terminal 进程启动和管理
GitWatcher	监控 Git 事件
CCSwitchService	模型配置切换

三层数据模型#

层级	说明
Workflow	顶层容器，包含多个 Task，配置 Orchestrator 和 Merge Terminal
WorkflowTask	中层单元，每个 Task 对应一个 Git 分支，包含多个 Terminal
Terminal	底层执行单元，绑定特定 CLI 类型和模型配置

典型应用场景#

场景	描述
跨 CLI 多 Agent 协作	Claude Code 主开发 + Codex audit/fix + Gemini CLI 文档/测试
同 CLI 多模型协作	前端用 glm-4.7，后端用 claude-opus-4.6，审核用 gpt-5.3-codex-xhigh
复杂任务闭环	Terminal A 实现 → Terminal B 审查测试 → Terminal C 审计收敛 → Merge Terminal 合并

安装部署#

前置要求#

工具	版本要求
Rust	nightly-2025-12-04
Node.js	>= 18（推荐 20）
pnpm	10.13.1
SQLite	3.x

快速开始#

# 克隆仓库
git clone https://github.com/huanchong-99/GitCortex
cd GitCortex

# 安装依赖
pnpm install

# 设置加密密钥（必须，32字符）
export GITCORTEX_ENCRYPTION_KEY="12345678901234567890123456789012"

# 构建后端
cargo build --release

# 启动开发服务器
pnpm run dev

访问地址：前端 http://localhost:23457，后端 API http://localhost:23456/api

环境变量#

变量	必填	说明
GITCORTEX_ENCRYPTION_KEY	✅	32 字符加密密钥
BACKEND_PORT	❌	后端端口（默认 23456）
HOST	❌	监听地址（默认 127.0.0.1）
GITCORTEX_API_TOKEN	❌	API Bearer 认证

支持的 CLI#

CLI	检测命令
Claude Code	`claude --version`
Gemini CLI	`gemini --version`
Codex	`codex --version`
Cursor Agent	`cursor --version`
Qwen Code	`qwen --version`

GitCortex