convez.ai
AgenteAutomaçãoAvançado
qianbkk

OrchFlow

qianbkk/OrchFlow

Orquestração de múltiplos agents de IA em painel desktop único com git isolado

Ver no GitHub
BomPluginScore · de 0 a 100

Aplicativo desktop que orquestra múltiplos AI agents de codificação (Claude Code, Codex, GitHub Copilot) em um painel unificado. Executa tarefas em paralelo, com isolamento via git worktree, aprovações de operações críticas, checkpoints e auditoria completa.

Instalação

$npx convez-ai qianbkk/OrchFlow

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
85%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Coordenar múltiplos agents de IA em tarefas de codificação simultaneamente
  • Executar pipelines DAG com dependências entre agents e compartilhamento de resultados
  • Isolar mudanças de código via git worktree para evitar conflitos entre agents
  • Revisar e aprovar operações de risco (deleção, merge, force push) antes de execução
  • Manter auditoria completa com checkpoints e possibilidade de rollback

Veredito

Solução sofisticada e bem arquitetada para quem gerencia múltiplos agents de IA em fluxos complexos. Exige configuração técnica (Node.js 22+, Git, CLIs específicas) mas oferece controle robusto, isolamento seguro e auditoria completa. Ideal para equipes que querem orquestração determinística sem risco.

README

A tradução para o português deste README ainda está na fila.

OrchFlow

AI 编码 Agent 编排桌面应用 — 在一个 Windows GUI 面板中统一管理 Claude Code / Codex / GitHub Copilot CLI。

OrchFlow 把多个 AI 编码 CLI 集中到一个桌面应用里,让你可以:

  • 同时跑多个 Agent(Claude / Codex / Copilot),实时看到各自输出
  • 每个 Task 自动开 git worktree 隔离,多 Agent 改同一仓库不冲突
  • 高危操作(删文件、装包、merge、force push)有审批门控
  • 自动创建 Checkpoint,出问题可回滚
  • 完整审计日志 + 高级过滤 + JSON/CSV 导出
  • 多种协作模式:并行广播 / 分工 / Pipeline DAG

功能一览

类别功能
Agent 接入Claude Code CLI · Codex CLI · GitHub Copilot CLI (gh copilot)
任务创建简单描述 · 任务列表(DAG 语法) · Agent 规划 · 文件导入 (.md/.json/.txt)
协作模式独立 · 并行广播(比较结果) · 分工(子任务分发) · Pipeline(依赖链)
终端xterm.js 嵌入式 + 全屏 · Headless ↔ Interactive 模式切换 · 外部终端弹出
审批风险评估 (high/medium/low) · 批量审批 · 按风险级别筛选
安全API Key 零明文 (keytar) · Electron sandbox · 路径沙箱 · IPC 白名单
GitWorktree 自动创建/销毁/Merge · Checkpoint + 回滚 · Diff 预览
可视化Sessions 终端 · Tasks 列表/看板 · Pipeline DAG (SVG) · 审计日志
消息总线Agent 间 text/diff/status/structured 传递 · 下游 prompt 自动注入
任务路由Auto-router 按负载/能力/历史自动分配 Agent

系统要求

  • Windows 10/11 (64-bit)
  • Node.js 22+ (开发用;node:sqlite 内建模块)
  • Git for Windows
  • 至少一个已安装的 CLI:@anthropic-ai/claude-code / @openai/codex / GitHub CLI + Copilot 扩展

快速开始

# 克隆 & 安装
git clone https://github.com/qianbkk/OrchFlow.git
cd OrchFlow
npm install

# 开发模式(Vite + Electron,自动打开窗口)
npm run dev

# 类型检查
npm run typecheck

# 运行测试(38 个测试)
npm run test

# 生产构建
npm run build

# 打包 Windows 安装包
npm run build:win

项目结构

src/
├── main/                  # Electron Main 进程
│   ├── index.ts           # 入口,窗口创建 + sandbox 配置
│   ├── ipc.ts             # IPC handler 集中注册(~30 个 handler)
│   ├── menu.ts            # 应用菜单 + 快捷键 (Ctrl+Shift+S)
│   ├── agents/            # Agent Driver 层
│   │   ├── driver.interface.ts   # IAgentDriver 统一接口
│   │   ├── driver.registry.ts    # 注册中心 + CLI 检测
│   │   ├── claude-code.driver.ts # Claude Code 完整实现
│   │   ├── codex.driver.ts       # Codex CLI 实现
│   │   └── copilot.driver.ts     # Copilot CLI 实现
│   ├── core/              # 业务逻辑引擎
│   │   ├── session-manager.ts    # Session 生命周期
│   │   ├── task-manager.ts       # 任务创建(4 种模式)+ 批量
│   │   ├── pipeline-engine.ts    # Pipeline DAG 拓扑排序 + 执行
│   │   ├── auto-router.ts        # 自动任务路由
│   │   ├── message-bus.ts        # Agent 间消息传递
│   │   ├── approval-gate.ts      # 审批门控
│   │   ├── checkpoint.ts         # Checkpoint + 回滚
│   │   └── settings-store.ts     # 设置(敏感字段保护)
│   ├── db/                # SQLite + 迁移 + Repositories
│   │   └── repositories/  # 7 个 repository 类
│   └── git/               # Worktree 管理
├── renderer/              # React 渲染进程
│   └── src/
│       ├── views/         # 5 个视图 (Sessions/Tasks/Pipeline/Audit/Settings)
│       ├── components/    # 12 个复用组件
│       └── stores/        # Zustand 状态 (sessions/ui)
├── preload/               # contextBridge API (window.orchflow)
└── shared/                # Main + Renderer 共享 types / events / constants

架构关键点

  • 统一 IAgentDriver 接口:新增 CLI = 新增实现 + 注册到 driver.registry.ts
  • PTY 共享:Headless / Interactive 模式共享同一 pty 进程,切换不中断 Agent
  • Worktree 隔离:每个 Task 自动 git worktree add,独立分支
  • Pipeline DAG:Kahn 算法拓扑排序 → 按依赖顺序执行 → 完成后传递消息给下游
  • Message Bus:上游 Task 完成后自动注入结果到下游 Agent 的 prompt 前缀
  • Auto-router:按 idle/running 数/历史成功率/能力匹配评分选择最佳 Agent
  • API Key 零明文:keytar → Windows Credential Manager,settings:get 阻止明文回传
  • 数据本地化:所有数据在 ~/.orchflow/ + SQLite

安全模型

层机制
Renderer 沙箱sandbox: true + contextIsolation: true + nodeIntegration: false
IPC 白名单RECEIVE_EVENTS 限制可订阅频道
凭据隔离keytar → Windows Credential Manager,永不明文
路径沙箱validateUserPath() 限制在 home 目录内
进程隔离每个 Task 独立 git worktree
审计追踪所有安全相关事件记录到 SQLite

已知限制:Approval Gate 当前为审计模式(记录但不物理阻断 Agent CLI 进程)。

测试

npm run test          # 38 个单元测试
npm run test:watch    # 监视模式
npm run test:coverage # 覆盖率报告

测试覆盖:events · constants · stores (sessions/ui) · auto-router 评分 · pipeline 拓扑排序 · message-bus 常量

文档

文件说明
ORCHFLOW_PRD.md产品需求文档 v1.0
CLAUDE.mdAI 行为约束 + 项目核心上下文
AGENTS.md跨 AI 工具通用编码规范
CONTRIBUTING.md贡献指南
SECURITY.md安全策略 + 漏洞报告
CHANGELOG.md版本变更记录
index.md关键文件速查表

路线图

Phase状态内容
Phase 0 MVP✅ 完成Claude Code · 单 Agent · Worktree · Approval · Checkpoint · 审计
Phase 1 协作核心✅ 完成Codex · 广播 · Message Bus · 看板 · 批量审批 · 任务列表
Phase 2 全功能✅ 完成Copilot · Pipeline DAG · Auto-router · 规划模式 · 多项目 · 高级过滤
Phase 3 打磨🔜 待定真正 PTY 拦截 · 代码签名 · E2E 测试 · 性能优化

许可

MIT

Ver o original no GitHub

Bom para

Relacionados