Skip to main content

Local Claude Code session scorer that contributes metrics to sentiments.cc

Project description

cc-sentiment

A CLI that scores your Claude Code conversations and contributes aggregate numbers to an open dashboard at sentiments.cc.

Your conversations stay on your device. Only signed aggregate numeric scores are uploaded to sentiments.cc; the server verifies signatures using a public key you control.

Run it

uvx cc-sentiment

Needs uv. Local scoring uses MLX on Apple Silicon when available; on other platforms the CLI still runs setup, upload, and dashboard sharing, and asks before using the configured fallback engine. The first run sets up a verification key (GitHub or GPG), scores transcripts in ~/.claude/projects/, and uploads the numbers.

What gets uploaded

The client uploads only numbers and timestamps for each 5-minute bucket of a conversation.

  • Sentiment score on a 1–5 scale
  • Read:edit ratio, edits-without-prior-read %, write:edit ratio, tool calls per turn, subagent spawn rate
  • Turn count, thinking present/chars
  • Claude model and Claude Code version
  • A public verification handle (GitHub username or GPG fingerprint) used only to find a public key and verify signatures

Your conversation text, file contents, file paths, prompts, tool inputs, and tool outputs are not uploaded to sentiments.cc.

Commands

Command Description
cc-sentiment Run the whole flow. Sets up if needed, then scans and uploads.
cc-sentiment setup Set up a verification key (GitHub or GPG) so uploads can be signed
cc-sentiment scan --upload Score new transcripts and upload
cc-sentiment scan Score transcripts without uploading
cc-sentiment upload Upload previously scored results
cc-sentiment rescan Clear state and re-score everything
cc-sentiment debug Print hardware, engine, Claude CLI, server, and Sentry probes for diagnostics

Links

Dashboard at sentiments.cc. Source and issues live on GitHub.

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

cc_sentiment-0.2.125.tar.gz (23.2 MB view details)

Uploaded Source

Built Distribution

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

cc_sentiment-0.2.125-py3-none-any.whl (23.2 MB view details)

Uploaded Python 3

File details

Details for the file cc_sentiment-0.2.125.tar.gz.

File metadata

  • Download URL: cc_sentiment-0.2.125.tar.gz
  • Upload date:
  • Size: 23.2 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for cc_sentiment-0.2.125.tar.gz
Algorithm Hash digest
SHA256 f4dda3a1f56652e788d5e4178c5fdde4cb6fb3e0de9ba7a0a2bc7ad54fb3d872
MD5 d072a13cc7d2f28da7febf54d9100e50
BLAKE2b-256 6b5b4dd45e9dc7e2bb068c01787b0fb5ea3671e9bcf09204e82c2040b4fd4249

See more details on using hashes here.

Provenance

The following attestation bundles were made for cc_sentiment-0.2.125.tar.gz:

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

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_sentiment-0.2.125-py3-none-any.whl.

File metadata

  • Download URL: cc_sentiment-0.2.125-py3-none-any.whl
  • Upload date:
  • Size: 23.2 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for cc_sentiment-0.2.125-py3-none-any.whl
Algorithm Hash digest
SHA256 2241842d3857c3a3a48e99c3dc54483a47ef3c7344a025edad61952099d24f3c
MD5 b9bb47bc5dbc8bcdcce6410a86185339
BLAKE2b-256 acd9f67d85ccc50b03183eba4f6caa391829fd72e1187609e2778790b0a3b97f

See more details on using hashes here.

Provenance

The following attestation bundles were made for cc_sentiment-0.2.125-py3-none-any.whl:

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

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

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page