Getting started

Install orch, put an agent CLI on your PATH, and run your first command. Triage decides whether the task is a quick-fix or needs the full complex pipeline.

Install

Install the CLI globally:

npm install -g @welluable/orch

Make sure an agent CLI is on your PATH — orch defaults to --agent cursor (the Cursor Agent CLI, command agent); claude (Claude Code) and agn are also supported.

First command

orch "fix the typo in the README"

That one command triages the request, and — because it’s small — fixes it directly in your current directory. For anything larger, orch stages a worktree and walks the full pipeline automatically.

What triage does

Triage classifies the task as a quick-fix or as complex work that needs research, plan, worktree, and the two verify loops. Small, safe edits go straight to a quick-fix agent in your current tree; larger tasks take the complex path.

Next → How it works