Management Layer

barkcli run

The autonomy loop: prompt → card → plan → N agents in worktrees → transcript watch → test gate → merge train. Done means the gate passes in the worktree, never that the agent said so.

Usage

barkcli run "<intent>" [--agents N] [--backend opencode|claude|codex] [--yes] [--offline] [--test-cmd cmd]

Examples

barkcli run "Create a fizzbuzz module with tests" --offline --yes
barkcli run "Ship the settings redesign" --agents 3 --yes
barkcli run "Fix the flaky login test" --backend claude --test-cmd "npm test" --yes
barkcli run "Add dark mode toggle" --dry-run

Flags

--agentsUp to N attempts run concurrently, each in its own worktree; gate-passing branches merge in finish order (merge train); max 16
--backendPick the agent runtime (default: auto-detect)
--yesAuto-merge branches that pass the gate
--offlineHeuristic intake, no LLM
--test-cmdOverride acceptance-gate detection
--max-attemptsRetry ceiling before permanent failure (default 3)
--jsonReport includes workers_peak and merged_branches