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.114.tar.gz (23.2 MB view details)

Uploaded Source

Built Distributions

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

cc_sentiment-0.2.114-cp313-abi3-win_amd64.whl (24.1 MB view details)

Uploaded CPython 3.13+Windows x86-64

cc_sentiment-0.2.114-cp313-abi3-manylinux_2_28_x86_64.whl (24.2 MB view details)

Uploaded CPython 3.13+manylinux: glibc 2.28+ x86-64

cc_sentiment-0.2.114-cp313-abi3-manylinux_2_28_aarch64.whl (24.1 MB view details)

Uploaded CPython 3.13+manylinux: glibc 2.28+ ARM64

cc_sentiment-0.2.114-cp313-abi3-macosx_11_0_x86_64.whl (24.1 MB view details)

Uploaded CPython 3.13+macOS 11.0+ x86-64

cc_sentiment-0.2.114-cp313-abi3-macosx_11_0_arm64.whl (24.1 MB view details)

Uploaded CPython 3.13+macOS 11.0+ ARM64

File details

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

File metadata

  • Download URL: cc_sentiment-0.2.114.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.114.tar.gz
Algorithm Hash digest
SHA256 85384996d4ef5b05be6270a5198e6a948f7814dd86839e5b17a3c288f62e0a31
MD5 f7f4f8c697f0d7d445c141c73f3a3876
BLAKE2b-256 6a5216610227cad8fc407c98ab339167059b6b4e9a153aec8384413b30ddc56f

See more details on using hashes here.

Provenance

The following attestation bundles were made for cc_sentiment-0.2.114.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.114-cp313-abi3-win_amd64.whl.

File metadata

File hashes

Hashes for cc_sentiment-0.2.114-cp313-abi3-win_amd64.whl
Algorithm Hash digest
SHA256 31ed853ab2927ca29440f156597b82da7695f0ceb533055d63027c046e9b78af
MD5 323832dea7e5b309a6b662be17e39fb5
BLAKE2b-256 e7e0e52469f14219ca4e190374ced86484f4dd7b2c026f19584fc994a96fcf0b

See more details on using hashes here.

Provenance

The following attestation bundles were made for cc_sentiment-0.2.114-cp313-abi3-win_amd64.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.

File details

Details for the file cc_sentiment-0.2.114-cp313-abi3-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for cc_sentiment-0.2.114-cp313-abi3-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 545221b06c7332c0e222d0a94d302feaf7c094323feab70989ad21457a239e16
MD5 1eeadc89f83ac700e5f91eeb24fdd117
BLAKE2b-256 ee079910a21e3b5ceb44671e4f9c78af92191876e40036b1f08e61621ee50af2

See more details on using hashes here.

Provenance

The following attestation bundles were made for cc_sentiment-0.2.114-cp313-abi3-manylinux_2_28_x86_64.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.

File details

Details for the file cc_sentiment-0.2.114-cp313-abi3-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for cc_sentiment-0.2.114-cp313-abi3-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 3f4a701619d3b183a468e55cfa29432b69f866bdb7834fe2ceec2cabb7d21db2
MD5 9915f3c39578994997725a9039a3d4b5
BLAKE2b-256 87a6d8d83096178bf7a0992fcf98819d7dd98c6ffbb5514ab08e60aa2525fd44

See more details on using hashes here.

Provenance

The following attestation bundles were made for cc_sentiment-0.2.114-cp313-abi3-manylinux_2_28_aarch64.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.

File details

Details for the file cc_sentiment-0.2.114-cp313-abi3-macosx_11_0_x86_64.whl.

File metadata

File hashes

Hashes for cc_sentiment-0.2.114-cp313-abi3-macosx_11_0_x86_64.whl
Algorithm Hash digest
SHA256 ee592e7cbb7d96cb0d03f1bb18dd8cb10eb8d958c198310f227346695ac5d561
MD5 56373f2a117cdceeb42c0011b276eaa7
BLAKE2b-256 4b63897c11b6fcffb07d18e0238c85c5e046878ac41e44f7c2c1039e0e32f4eb

See more details on using hashes here.

Provenance

The following attestation bundles were made for cc_sentiment-0.2.114-cp313-abi3-macosx_11_0_x86_64.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.

File details

Details for the file cc_sentiment-0.2.114-cp313-abi3-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for cc_sentiment-0.2.114-cp313-abi3-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 0247e293309e87fd9a5725625a15350cf09c6b4f71c2bd9e5fa265e0283c2207
MD5 de21e5754759de977edf496e75d4ac38
BLAKE2b-256 d37d9ed2ddd39acc6f2820d4c22e3dc47f2cc5604bc07a135d627b88d799196e

See more details on using hashes here.

Provenance

The following attestation bundles were made for cc_sentiment-0.2.114-cp313-abi3-macosx_11_0_arm64.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