Commands cheat sheet

All commands run from the target repo (e.g. Fulreach) or with mainark -C /path/to/repo ….

Full parallel pipeline

mainark parallel clean
mainark implement FUL-576 FUL-419 FUL-578
# agents → local review → push → stacked PRs → optional PR review loop

implement uses one .mainark/parallel.json for the whole clone. The CLI refuses to start a new batch when leftover slots are still registered — parallel list, then clean or remove, or pass --append to combine stacks on purpose.

Inspect before running

mainark parallel --plan FUL-576 FUL-419 FUL-578   # reliable preview (no agents/ship)
mainark implement --plan FUL-576 FUL-419 FUL-578  # same: --plan is transitive (no --implement)

--plan / --dry-run must not dispatch agents, write .mainark/parallel.json, create worktrees, push, publish, or ship. A mixed registry exits 1 on preview and on a real run unless you pass --append.

mainark parallel agents, ship, push, publish, local-until-clean, and until-clean with no issue ids refuse a non-empty registry unless --append. Pass explicit ids to operate on those slots only.

Agents without ship

mainark implement FUL-576 --no-ship
mainark parallel agents-status --watch

Epic phases

mainark plan FUL-416
mainark implement FUL-416
mainark implement FUL-416 --resume              # after phase merges
mainark implement FUL-416 --parallel --no-ship
mainark status FUL-416

Partial steps

mainark parallel FUL-407 FUL-409     # worktrees only
mainark parallel paths               # cd targets
mainark parallel local-until-clean   # pre-push review per slot
mainark parallel push --yes
mainark parallel publish
mainark parallel ship --yes-push

Registry maintenance

mainark parallel list
mainark parallel clean
mainark parallel remove FUL-407

Flags

Flag	Effect
`--no-ship`	Stop after agents (no push/review ship)
`--no-stack`	Legacy: wave 1 off main only; wait for merge between waves
`--plan` / `--dry-run`	Preview only: no agents, worktrees, registry writes, push, or ship. Mixed registry exits 1 unless `--append`
`--append`	Keep leftover `parallel.json` slots / operate on the whole registry (opt-in)
`--parallel`	Epic current phase via worktree stack

Environment

Variable	Purpose
`MAINARK_PARALLEL_BASE`	Worktree parent dir
`MAINARK_PARALLEL_JOBS`	Concurrent review/fix jobs (default 2)
`MAINARK_IMPLEMENT_STATE`	Linear state for queue (default Todo)
`MAINARK_MODE=cloud`	Codex-primary fix chain on review

Install and review-loop details: Local CLI.