ORCH — CLI runtime that complements ADK with process orchestration for coding agents

[oxgeneral]

Turn Claude, Cursor, and Codex into one team.

Built ORCH — an open-source CLI runtime that manages AI coding agents (Claude Code, OpenCode, Codex, Cursor) as a typed engineering team with formal state machine, auto-retry, and inter-agent messaging.

ADK-Python and ORCH operate at complementary layers: ADK focuses on agent reasoning, tool use, and LLM integration in Python. ORCH handles the process orchestration layer — spawning, monitoring, and coordinating external agent processes from a CLI with structured lifecycle management.

Technical architecture:

• State machine: todo to in_progress to review to done, with retrying on failure
• Adapter system: pluggable process adapters (claude, opencode, codex, cursor, shell)
• Inter-agent messaging: pub-sub via orch msg send and orch msg broadcast
• Shared context: orch context set/get for agents to share pipeline state
• Programmatic API: @oxgeneral/orch npm package for embedding in Node.js apps

For ADK users building multi-agent systems: ORCH can complement ADK workflows by managing the execution of coding-focused agents in parallel while ADK handles reasoning and tool orchestration.

Quick start:
npm install -g @oxgeneral/orch
orch agent add backend --adapter claude
orch agent add reviewer --adapter cursor
orch task add Implement OAuth --assignee backend
orch tui

1493 tests, TypeScript strict, ESM, Node 20+. MIT license.

GitHub: https://github.com/oxgeneral/ORCH