Add ORCH — CLI orchestrator for AI agent teams (Workflow Orchestration)

[oxgeneral]

Plugin Suggestion

Name: ORCH
Category: Workflow Orchestration

Description

ORCH is a CLI runtime that turns Claude Code, Codex, Cursor, and shell scripts into a coordinated AI engineering team. Unlike simple parallel runners, ORCH provides a full state machine with mandatory review gates, auto-retry on failure, and inter-agent messaging — so agents don't just run in parallel, they work as a managed team.

Features

• State machine governance — Tasks flow through todo → in_progress → review → done with mandatory approval gates before completion
• Auto-retry resilience — Failed agents automatically enter retrying state without manual intervention
• Inter-agent messaging — Agents message each other and share a context store (orch msg send, orch context set)
• Multi-adapter support — Claude Code, OpenCode, Codex, Cursor, and any shell command as agents
• TUI dashboard — Real-time Ink/React terminal dashboard with task/agent/goal views
• Goal system — High-level goals decompose into task hierarchies with progress tracking
• Team structure — Group agents into named teams with roles (engineering, marketing, security)
• Programmatic API — @oxgeneral/orch exports full engine API for embedding in Node.js apps
• Headless daemon mode — 24/7 server operation with JSON logging
• No infrastructure — File-only storage (YAML/JSON/JSONL), no database or cloud required

Installation

npm install -g @oxgeneral/orch

Quick Start

# Initialize ORCH in any project
orch init

# Add an agent (Claude Code)
orch agent add "Backend Dev" --adapter claude

# Add a task and it gets auto-dispatched
orch task add "Implement auth module" -d "JWT + refresh tokens" -p 1

# Watch agents work in real-time TUI
orch tui

# Send a message between agents
orch msg send <agent-id> "Auth PR is ready for review"

Links

• GitHub: https://github.com/oxgeneral/ORCH
• npm: https://www.npmjs.com/package/@oxgeneral/orch
• Tests: 1,647 passing (TypeScript strict, MIT license)

---

ORCH is the only CLI orchestrator with a mandatory review gate (in_progress → review → done) and inter-agent messaging — making it uniquely suited for Workflow Orchestration rather than simple parallel execution.