# cc-steer


Collect developer steering signals from existing Claude Code transcripts.


``` bash
cc-steer [OPTIONS] COMMAND [ARGS]...
```


<span class="gd-details-chevron" aria-hidden="true"></span>Full --help output


    Usage: cc-steer [OPTIONS] COMMAND [ARGS]...

      Collect developer steering signals from existing Claude Code transcripts.

    Options:
      --version  Show the version and exit.
      --help     Show this message and exit.

    Commands:
      audit               Audit a seeded stratified sample of the current...
      compare-arms        Verdict two sweep score reports under the...
      decisions           Mine and summarize AskUserQuestion decision rounds...
      enrich              Ground every refined pair in the code evidence...
      eval                Compute the mechanical metrics for the current...
      evidence            Search the refined-pair evidence index by BM25,...
      exemplars           Retrieve the exemplars the frontier refiner would...
      export              Export the steering lineage as a HuggingFace dataset.
      freeze-eval         Freeze the gate, watcher, steer-type, and pick eval...
      golden              Author, verify, and audit the blind watcher-fires...
      hooks               Manage the global SessionEnd hook that feeds...
      hosted              Calibrate and promote a watcher adapter for a...
      import              Import cc-factory decision outcomes as judged-pair...
      inbox               List recent and undelivered steers -- the fallback...
      index               Embed the accepted steering exemplars for the...
      list                List recent feedback events, newest first.
      live                Control live steering: the delivery mode, the kill...
      models              Inspect and flip the registry of lab-trained model...
      pairs               Print the refined training pairs -- the pipeline's...
      pipeline            Run the collection stages as one budgeted,...
      predict             Predict a steering decision from recorded evidence.
      profile             Print the per-category steering profile built from...
      prune-gate-samples  Delete gate samples whose rendered text has no...
      rebuild-context     Rebuild stored contexts from their source session...
      refine              Refine every accepted steering event into atomic...
      retrain             Retrain and (conditionally) promote one component...
      sample-negatives    Sample gate training windows: rewound positives,...
      scan                Scan transcripts for feedback, incrementally.
      score-watcher       Score one watcher recipe under the uniform...
      shadow              Analyze the live watcher's shadow-mode proposals.
      stats               Print ingestion counts by source kind and triage...
      thresholds          Re-fit served cascade thresholds from the live...
      triage              Judge every stored candidate lacking a verdict at...
      view-samples        Serve the training-pairs dashboard: refined pairs...
      watch               Tail live transcripts and run the steering cascade,...


# Options


`--version`  
Show the version and exit.


# Commands


`scan`  
[Scan transcripts for feedback, incrementally.](../../reference/cli/scan.md)

`rebuild-context`  
[Rebuild stored contexts from their source session transcripts.](../../reference/cli/rebuild_context.md)

`prune-gate-samples`  
[Delete gate samples whose rendered text has no substantive content.](../../reference/cli/prune_gate_samples.md)

`stats`  
[Print ingestion counts by source kind and triage coverage.](../../reference/cli/stats.md)

`list`  
[List recent feedback events, newest first.](../../reference/cli/list.md)

`triage`  
[Judge every stored candidate lacking a verdict at the current prompt version.](../../reference/cli/triage.md)

`audit`  
[Audit a seeded stratified sample of the current prompt version's verdicts.](../../reference/cli/audit.md)

`eval`  
[Compute the mechanical metrics for the current prompt version.](../../reference/cli/eval.md)

`refine`  
[Refine every accepted steering event into atomic training pairs.](../../reference/cli/refine.md)

`enrich`  
[Ground every refined pair in the code evidence behind it.](../../reference/cli/enrich.md)

`export`  
[Export the steering lineage as a HuggingFace dataset.](../../reference/cli/export.md)

`pairs`  
[Print the refined training pairs -- the pipeline's deliverable.](../../reference/cli/pairs.md)

`sample-negatives`  
[Sample gate training windows: rewound positives, hard and random negatives.](../../reference/cli/sample_negatives.md)

`index`  
[Embed the accepted steering exemplars for the frontier refiner's retrieval.](../../reference/cli/index.md)

`exemplars`  
[Retrieve the exemplars the frontier refiner would see for a steering context.](../../reference/cli/exemplars.md)

`hooks`  
[Manage the global SessionEnd hook that feeds continual collection.](../../reference/cli/hooks.md)

`live`  
[Control live steering: the delivery mode, the kill switch, and the prompt-submit hook.](../../reference/cli/live.md)

`inbox`  
[List recent and undelivered steers -- the fallback surface when the hook stays quiet.](../../reference/cli/inbox.md)

`models`  
[Inspect and flip the registry of lab-trained model versions.](../../reference/cli/models.md)

`decisions`  
[Mine and summarize AskUserQuestion decision rounds from transcript trees.](../../reference/cli/decisions.md)

`thresholds`  
[Re-fit served cascade thresholds from the live scored-moment distribution.](../../reference/cli/thresholds.md)

`hosted`  
[Calibrate and promote a watcher adapter for a hosted serving substrate, distinct from the local lane.](../../reference/cli/hosted.md)

`retrain`  
[Retrain and (conditionally) promote one component through the model registry.](../../reference/cli/retrain.md)

`score-watcher`  
[Score one watcher recipe under the uniform Tinker-frame instrument and write `.athome-metric.json`.](../../reference/cli/score_watcher.md)

`compare-arms`  
[Verdict two sweep score reports under the instrument card's paired-DeLong rule.](../../reference/cli/compare_arms.md)

`freeze-eval`  
[Freeze the gate, watcher, steer-type, and pick eval views into ~/.cc-steer/eval/.](../../reference/cli/freeze_eval.md)

`golden`  
[Author, verify, and audit the blind watcher-fires golden labeling packet.](../../reference/cli/golden.md)

`pipeline`  
[Run the collection stages as one budgeted, schedulable pass.](../../reference/cli/pipeline.md)

`watch`  
[Tail live transcripts and run the steering cascade, delivering per `~/.cc-steer/live.toml`.](../../reference/cli/watch.md)

`shadow`  
[Analyze the live watcher's shadow-mode proposals.](../../reference/cli/shadow.md)

`view-samples`  
[Serve the training-pairs dashboard: refined pairs and their full lineage.](../../reference/cli/view_samples.md)

`evidence`  
[Search the refined-pair evidence index by BM25, optionally MMR-reranked.](../../reference/cli/evidence.md)

`import`  
[Import cc-factory decision outcomes as judged-pair candidates.](../../reference/cli/import.md)

`profile`  
[Print the per-category steering profile built from the refined pairs.](../../reference/cli/profile.md)

`predict`  
[Predict a steering decision from recorded evidence.](../../reference/cli/predict.md)
