Docs/Reference

CLI reference

The vulgr and orchestrate commands.

Vulgr ships two commands:

  • vulgr — starts the desktop app (vulgr.js).
  • orchestrate — runs the core multi-agent engine straight from your terminal or CI/CD pipelines (index.ts).

orchestrate mesh

Runs the autonomous three-agent network (Agent Swarm).

orchestrate mesh "Add a JWT refresh token to user login" \
  --builder claude \
  --verifier agy \
  --auditor claude \
  --verify-cmd "npm test" \
  --max-rounds 3

orchestrate orchestra

Splits a big goal into subtasks and runs them in parallel across several agents (Orchestrator).

orchestrate orchestra "Move the REST API endpoints to a GraphQL schema" \
  --planner claude \
  --workers claude,agy,codex \
  --reviewer claude \
  --parallel 3 \
  --max-rounds 2

orchestrate run

Has the primary agent write code, runs a self-correction loop, then does an adversarial review with a second agent.

orchestrate run "Fix the race condition in the payments module" \
  --primary claude \
  --reviewer gemini \
  --verify \
  --verify-cmd "npm test" \
  --dual \
  --max-retries 2

orchestrate doctor / clean

# Checks your Node, Git, Claude CLI and Gemini CLI installs
orchestrate doctor

# Removes past run records under .ai-bridge/runs/
orchestrate clean