How dheerax/orchy works
Orchy is a VS Code extension that lets an external AI assistant propose and manage multi-agent coding runs. The main workflow is MCP tool requests to the extension daemon, plan approval, agent execution in isolated Git worktrees, deliverable verification, and merge; the VS Code panel exposes session, pipeline, and Git-history views. The extension host owns persistent session state, replayed from an append-only event log. Major orchestration internals and UI sources were not excerpted, so their detailed call paths are shown only where documented, or left unverified.
Main entry points: extension.ts Extension host · orchestrator.ts Run orchestrator · server.ts HTTP daemon · sessionRegistry.ts Session registry
Components 19
Entry points
- MCP tools
mcp/orchy-mcp.mjs - Extension host
src/extension.ts - HTTP daemon
src/daemon/server.ts
Planning and policy
- Plan DAG
src/core/planner.ts - Project config
src/core/projectConfig.ts - Model policy
src/core/modelPolicy.ts - Setup checks
src/core/doctor.ts
Agent runtime
- Run orchestrator
src/core/orchestrator.ts - Git worktrees
src/core/worktreeManager.ts - OpenCode backend
src/backends/opencodeBackend.ts - OpenCode client
src/backends/opencodeClient.ts - Deliverable verifier
src/core/deliverableVerifier.ts - Contract checker
src/core/contractChecker.ts
Session state
- Session registry
src/core/sessionRegistry.ts - Event log
src/core/eventLog.ts
VS Code experience
- Mission control
src/ui/graphPanel.ts - Transcript view
src/ui/transcriptDocument.ts
Other components
- AI assistant
- OpenCode server
Connections 28
- AI assistant → MCP tools: invokes tools
README.md - MCP tools → HTTP daemon: forwards HTTP
README.md - Extension host → HTTP daemon: starts and configures
src/extension.ts - HTTP daemon → Run orchestrator: dispatches requests
src/daemon/server.ts - HTTP daemon → Session registry: reads sessions
src/daemon/server.ts - HTTP daemon → Project config: loads config
src/daemon/server.ts - HTTP daemon → Plan DAG: checks plan status
src/daemon/server.ts - Extension host → Run orchestrator: wires orchestration
src/extension.ts - Extension host → Git worktrees: checks repository
src/extension.ts - Extension host → Setup checks: runs setup checks
src/extension.ts - Extension host → Deliverable verifier: uses verification
src/extension.ts - Extension host → Session registry: uses session state
src/extension.ts - Extension host → Mission control: registers panel
src/extension.ts - Extension host → Transcript view: registers transcript
src/extension.ts - Session registry → Event log: replays and reads
src/core/sessionRegistry.ts - Run orchestrator → Plan DAG: builds and runs plans
- Run orchestrator → Git worktrees: creates isolated branches
- Run orchestrator → OpenCode backend: starts agent sessions
- Run orchestrator → Deliverable verifier: verifies deliverables
- Run orchestrator → Contract checker: checks promises
- Run orchestrator → Session registry: updates sessions
- OpenCode backend → OpenCode client: uses API client
src/backends/opencodeBackend.ts - OpenCode client → OpenCode server: sends API requests
- OpenCode backend → Model policy: applies model policy
src/backends/opencodeBackend.ts - Git worktrees → OpenCode server: provides isolated directories
- Mission control → Session registry: renders session state
- Transcript view → Session registry: reads session records
- Transcript view → OpenCode backend: loads live transcript