usage: flowctl.py [-h]
                  {init,setup-block,detect,status,config,tracker,sync,pilot-log,pilot,review-backend,review-findings,review-rounds,review-route,review-artifact,memory,prospect,chart,anchor,brief,repo-map,prime,glossary,criteria,strategy,spec,scope,pr-cognitive-aid,task,dep,show,specs,tasks,list,cat,usage,ready,next,start,done,block,validate,triage-skip,gate,checkpoint,rp,codex,copilot,cursor,claude,review-deep-auto,review-walkthrough-defer,review-walkthrough-record} ...

flowctl - CLI for .flow/ task tracking

positional arguments:
  {init,setup-block,detect,status,config,tracker,sync,pilot-log,pilot,review-backend,review-findings,review-rounds,review-route,review-artifact,memory,prospect,chart,anchor,brief,repo-map,prime,glossary,criteria,strategy,spec,scope,pr-cognitive-aid,task,dep,show,specs,tasks,list,cat,usage,ready,next,start,done,block,validate,triage-skip,gate,checkpoint,rp,codex,copilot,cursor,claude,review-deep-auto,review-walkthrough-defer,review-walkthrough-record}
    init                Initialize .flow/ directory
    setup-block         Apply or resolve the tracked Flow-Next docs block
    detect              Check if .flow/ exists
    status              Show .flow state and active runs
    config              Config commands
    tracker             Deterministic tracker transport verbs (fn-139)
    sync                Tracker sync plumbing (config / state / enumerate /
                        receipt)
    pilot-log           Pilot backlog-mode decision log (append / summary)
    pilot               Pilot state helpers (strikes ledger)
    review-backend      Get review backend (ASK if not configured)
    review-findings     Attach versioned structured findings to a direct-
                        writer receipt
    review-rounds       Deterministic review-round cap counter (rp workflows:
                        increment before dispatch, reset on SHIP)
    review-route        Decide the next impl-review shape for a scope (fanout
                        | fix-then-rereview | stop) and derive its receipt
                        path
    review-artifact     Build the exact domain-separated artifact blob for an
                        RP review fence
    memory              Memory commands
    prospect            Prospect artifact commands
    chart               Chart commands (decision-map discovery; fn-135)
    anchor              Single-call worker anchor bundle — verbatim Phase-1
                        re-anchor reads (task+spec show/cat, git state, memory
                        flag, glossary, memory index, dependencies) in one
                        deterministic payload
    brief               Session-scope re-anchor brief — open specs, actionable
                        tasks, recent completions, memory index (token-
                        bounded, deterministic)
    repo-map            Read clawpatch's `.clawpatch/features/*.json` feature
                        index. Bypasses .flow/ guard — gates on .clawpatch/
                        presence.
    prime               Prime deterministic helpers (classify). Bounded, pure-
                        stdlib, no LLM — the skill layers judgment on the
                        emitted signals.
    glossary            Project glossary commands (GLOSSARY.md at repo root or
                        nearest ancestor). Lives outside .flow/ so it survives
                        flow-next removal.
    criteria            Global acceptance criteria (.flow/criteria.md)
    strategy            Project strategy commands (STRATEGY.md at repo root,
                        single-root). Lives outside .flow/ so it survives
                        flow-next removal. Read-only plumbing — the skill
                        writes the file.
    spec                Spec commands (canonical)
    scope               Scope helpers for --scope=business|technical|both
                        (parser + write policy)
    pr-cognitive-aid    Validate, persist, select, and render a v1 PR
                        cognitive-aid artifact
    task                Task commands
    dep                 Dependency commands
    show                Show spec or task
    specs               List all specs
    tasks               List tasks
    list                List all specs and tasks
    cat                 Print spec markdown
    usage               Print the bundled usage guide (CLI + orchestration
                        recipes)
    ready               List ready tasks
    next                Select next plan/work unit
    start               Start task
    done                Complete task
    block               Block task with reason
    validate            Validate spec or all
    triage-skip         Trivial-diff triage pre-check (exit 0=SKIP, 1=REVIEW,
                        2+=error)
    gate                Gate-diet commands: green receipts + docs-only tiering
                        (fn-102)
    checkpoint          Checkpoint commands
    rp                  RepoPrompt helpers
    codex               Codex CLI helpers
    copilot             GitHub Copilot CLI helpers
    cursor              Cursor (cursor-agent CLI) helpers
    claude              Claude Code (claude CLI) helpers
    review-deep-auto    Print deep passes that auto-enable for a changed-file
                        list (fn-32.2)
    review-walkthrough-defer
                        Append deferred findings to .flow/review-
                        deferred/<branch>.md (fn-32.3). Append-only; creates
                        the directory if absent.
    review-walkthrough-record
                        Stamp the receipt with walkthrough bucket counts
                        (fn-32.3). Additive — never changes verdict.

options:
  -h, --help            show this help message and exit
