# cc-steer scan


Scan transcripts for feedback, incrementally.


``` bash
cc-steer scan [OPTIONS]
```


Each transcript is parsed only when new or modified since the last scan, and every candidate is inserted with `INSERT OR IGNORE` keyed by a content digest, so re-running [scan](../scanning.md#cc_steer.scan.scan) over unchanged inputs is a no-op. Recording a file and inserting its candidates commit in one transaction. With `--findings`, superset `issues.jsonl` files under the given directories are anchored to the closest session and recorded through the same idempotent insert. A pass that changes data syncs the dataset to HuggingFace; `--no-sync` skips it.


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


    Usage: cc-steer scan [OPTIONS]

      Scan transcripts for feedback, incrementally.

      Each transcript is parsed only when new or modified since the last scan, and
      every candidate is inserted with ``INSERT OR IGNORE`` keyed by a content
      digest, so re-running ``scan`` over unchanged inputs is a no-op. Recording a
      file and inserting its candidates commit in one transaction. With
      ``--findings``, superset ``issues.jsonl`` files under the given directories
      are anchored to the closest session and recorded through the same idempotent
      insert. A pass that changes data syncs the dataset to HuggingFace; ``--no-
      sync`` skips it.

    Options:
      --transcripts DIRECTORY  Transcript directories to scan. Defaults to
                               ~/.claude/projects.
      --findings DIRECTORY     Directories to search for superset issues.jsonl
                               findings files. May be repeated.
      --full                   Re-scan every transcript, ignoring recorded mtimes.
      --db FILE                Database path. Defaults to ~/.cc-steer/feedback.db.
      --sync / --no-sync       Rebuild the derived dataset and push it to your
                               private HuggingFace repo when the pass changed
                               data.  [default: sync]
      --help                   Show this message and exit.


# Options


`--transcripts: DIRECTORY`  
Transcript directories to scan. Defaults to ~/.claude/projects.

`--findings: DIRECTORY`  
Directories to search for superset issues.jsonl findings files. May be repeated.

`--full`  
Re-scan every transcript, ignoring recorded mtimes.

`--db: FILE`  
Database path. Defaults to ~/.cc-steer/feedback.db.

`--sync, --no-sync`  
Rebuild the derived dataset and push it to your private HuggingFace repo when the pass changed data.