Skip to content

Add ORCH β€” CLI runtime for AI agent team orchestration#106

Open
oxgeneral wants to merge 1 commit intojim-schwoebel:mainfrom
oxgeneral:add-orch-orchestrator
Open

Add ORCH β€” CLI runtime for AI agent team orchestration#106
oxgeneral wants to merge 1 commit intojim-schwoebel:mainfrom
oxgeneral:add-orch-orchestrator

Conversation

@oxgeneral
Copy link
Copy Markdown

What is ORCH?

ORCH is a CLI runtime for orchestrating AI agent teams β€” it coordinates Claude Code, OpenCode (Codex/Gemini/Mistral), Cursor, and shell scripts as a typed engineering team with full lifecycle management.

Why it belongs in Frameworks

ORCH fits alongside frameworks like AutoGen, CrewAI, and LangGraph with a unique CLI-first, runtime approach:

  • Formal state machine: todo β†’ in_progress β†’ review β†’ done with validated transitions and a mandatory review gate before completion
  • Auto-retry: Failed agents automatically enter retrying state β€” no silent failures
  • Inter-agent messaging: orch msg send <agent-id> "message" β€” agents coordinate directly
  • Goal β†’ Task hierarchy: High-level goals broken into tasks with dependency ordering
  • Teams: Named agent teams with roles
  • Shared context store: orch context set <key> <value> β€” agents share runtime state
  • TUI dashboard: Ink/React real-time terminal UI

1647 tests (Vitest), MIT license, Node 20+.

Quick start

npm install -g @oxgeneral/orch
orch agent list           # View pre-configured agents
orch task add "Write auth module" -d "JWT + refresh tokens" --assignee backend
orch msg send backend "Check the security requirements in context"
orch tui                  # Live TUI dashboard

GitHub: https://github.com/oxgeneral/ORCH
npm: https://npmjs.com/package/@oxgeneral/orch
License: MIT

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant