ORCH — built this to orchestrate the full coding task lifecycle that ends with a review gate

[oxgeneral]

What I built

ORCH — a TypeScript CLI runtime for orchestrating teams of AI coding agents.

How it connects to PR-Agent workflows

PR-Agent excels at reviewing pull requests autonomously. The gap I hit: who orchestrates the full lifecycle — from task assignment to code generation to the review step?

ORCH models this as a typed state machine:

todo → in_progress → review → done

The review step maps naturally to what PR-Agent does — but ORCH ensures no task bypasses it. An agent (or PR-Agent via webhook) must explicitly transition tasks through review.

Example workflow

1. ORCH assigns a coding task to a Claude Code agent
2. Agent completes → task enters review state
3. A review agent (or PR-Agent webhook) inspects the diff, transitions to done
4. If the coding agent crashes mid-task → retrying state, auto-restarted

orch task add "Add rate limiting to API" --assignee agt_coder
# after code is written:
orch task update tsk_abc --status review
# after review passes:
orch task update tsk_abc --status done

Details

• 1647 tests, TypeScript strict, MIT
• Adapters: Claude Code, OpenCode, Cursor, shell
• npm install -g @oxgeneral/orch

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