Skip to main content
Yanked

This release has been yanked by its maintainers, and will be ignored by installers, except when explicitly specified.
Reason given by maintainers: Project renamed to cc-steer — install cc-steer instead (https://pypi.org/project/cc-steer/)

cc-pushback

cc-pushback banner

PyPI Python Docs License: PolyForm-Noncommercial-1.0.0

Mine your Claude Code transcripts for the moments you pushed back into a local database.

cc-pushback collects your corrections, interrupts, rejected plans, and code-review comments — with the surrounding conversational context — into a feedback database. That corpus is the raw material for learning your pushback style; this first release builds it. Your taste is mostly tacit (you notice a rule when it's violated), and that signal sits unused in transcript files; this turns it into a structured dataset.

Install

Run with uvx: uvx cc-pushback --help.

Quickstart

Scan your transcripts and accumulate the pushback into a local feedback database:

uvx cc-pushback scan
scanned 412 files, 1473 new rows

scan is incremental and idempotent: each transcript is parsed only when new or changed, every candidate is keyed by a content digest, and recording a file commits in one transaction, so an interrupted scan never leaves the database half-written. The database lives at ~/.cc-pushback/feedback.db by default (override with --db).

Commands

Command What it does
scan Scan transcripts for pushback, incrementally. --full re-mines every transcript; --transcripts DIR (repeatable) scans other directories.
stats Counts by source kind and the scanned-file count.
list Recent feedback, newest first. --source KIND (repeatable) and --limit N.

Run uvx cc-pushback COMMAND --help for the full flag list.

What gets collected

scan runs four detectors over each transcript, each tagged with a source kind: transcript messages (transcript_message, the pushback you typed mid-session), plan reviews (plan_review, rejected ExitPlanMode plans and plan-mode re-entries), interrupts and rejections (interrupt_rejection, permission denials and user interrupts), and review comments (review_comment, one row per inline code-review comment). Each row carries the conversational window around the feedback, captured at collection time because transcripts are ephemeral.

Mining from another machine

Transcripts live under ~/.claude/projects. Mirror a remote machine's history locally, then point scan at it — --transcripts is repeatable, so several mirrors fold into one scan:

rsync -az yasyf@yasyf:.claude/projects/ ~/.cc-pushback/mirrors/yasyf/
uvx cc-pushback scan --transcripts ~/.cc-pushback/mirrors/yasyf/

Docs

Read the docs for the full guide and API reference.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cc_pushback-0.7.1.tar.gz (57.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cc_pushback-0.7.1-py3-none-any.whl (69.4 kB view details)

Uploaded Python 3

File details

Details for the file cc_pushback-0.7.1.tar.gz.

File metadata

  • Download URL: cc_pushback-0.7.1.tar.gz
  • Upload date:
  • Size: 57.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for cc_pushback-0.7.1.tar.gz
Algorithm Hash digest
SHA256 2d7103259cb67b130743336e88a502f445adcf8cf0236dc0cd16cc72519d4104
MD5 db21e875ece98bd7d44e8409ff6ce1cc
BLAKE2b-256 7f6740e46a9d4e63b3fbaf969da6a548865c05777cf038fbe478a72e80558c59

See more details on using hashes here.

Provenance

The following attestation bundles were made for cc_pushback-0.7.1.tar.gz:

Publisher: release-pypi.yml on yasyf/cc-pushback

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file cc_pushback-0.7.1-py3-none-any.whl.

File metadata

  • Download URL: cc_pushback-0.7.1-py3-none-any.whl
  • Upload date:
  • Size: 69.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for cc_pushback-0.7.1-py3-none-any.whl
Algorithm Hash digest
SHA256 b6d5634d0b852c755cfecf88c0c57b81f4e5f37a3b41c8d2d9d6100cf02992d7
MD5 33ad16cb0822355eefd0c8eaabebc70d
BLAKE2b-256 a247fc54ec3f653963a259054be2a0fdfea0f13ff384e88c36b8d32b8e118cf0

See more details on using hashes here.

Provenance

The following attestation bundles were made for cc_pushback-0.7.1-py3-none-any.whl:

Publisher: release-pypi.yml on yasyf/cc-pushback

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.8.1

2 files

0.8.0

2 files

0.7.2

2 files

This release

0.7.1 This release

2 files

0.7.0

2 files

0.6.0

2 files

0.5.0

2 files

0.4.0

2 files

0.3.0

2 files

0.2.0

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page