cc-steer scan

Scan transcripts for feedback, incrementally.

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 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.

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.