ORCH — CLI orchestrator for AI agent teams (TypeScript, Claude Code, Codex, Cursor)

[oxgeneral]

Hey community! 👋

I built ORCH — an open-source CLI orchestrator that coordinates teams of AI coding agents from the terminal.

What it does

When running multiple AI agents (Claude Code, Codex, Cursor) simultaneously on a project, coordination becomes the bottleneck. ORCH solves this:

npm install -g @oxgeneral/orch

orch agent add "architect" --adapter claude --model claude-opus-4-6
orch agent add "coder" --adapter codex

orch task add "Design new feature" -p 1 --assignee architect
orch task add "Implement feature" -p 2 --assignee coder --scope "src/feature/**"

orch tui  # live TUI dashboard showing all agents and tasks

Key features

• State machine — todo → in_progress → review → done with auto-retry on failure
• Scope locking — prevents agents from editing the same files simultaneously
• Inter-agent messaging — agents pass context to each other automatically
• Goal tracking — high-level goals decompose into agent task queues
• Zero infrastructure — plain YAML/JSON files, no database required

1,657 passing tests · TypeScript strict · MIT · https://github.com/oxgeneral/ORCH

Happy to discuss! 🚀

[Senthil455]

Interesting project. The scope-locking and inter-agent messaging are the features that actually address real pain points when running multiple agents on the same codebase. Without file-level locking, you get merge conflicts from agents stepping on each other.
A few things I'd look at before adopting it:

• How does scope locking handle rebases or branch switches? If an agent locks src/feature/X, then the main branch moves, does the lock become stale?
• State machine with auto-retry on failure can mask real issues -- what's the retry strategy? Same agent with context, or a fresh agent? Exponential backoff?
• 1,657 tests is nice, but what's the coverage on concurrent agent scenarios (3+ agents, overlapping scopes)? That's where race conditions live.
  The zero-infrastructure design (YAML/JSON files, no DB) is a good call for adoption -- one less thing to sell a team on.