Skip to main content

havrin

See where your Claude Code usage goes, from the session logs Claude Code already keeps on your machine.

pipx install havrin        # or: pip install havrin
havrin meter --days 30 --what-if --subagent-types

The meter reads the JSONL transcripts in ~/.claude/projects and prints:

  • tokens by kind (input, cache writes, cache reads, output) and each kind's cost-weighted share;
  • which tools filled the context, in characters;
  • with --what-if: the share of cost you would have saved with subagents on Sonnet, with the main context capped (150k tokens by default), and with both. These are estimates replayed from your own logs, not promises.
  • with --subagent-types: subagent cost broken down by subagent type, and whether the Agent call asked for a model;
  • with --context-ranking: the kinds of tool output (git diff, pytest, whole-file reads...) that fill the context most, and how much went to re-reading files that hadn't changed.

Privacy: it only reads local files, sends nothing anywhere, and prints counts, never the content of your sessions.

Options: --days N (default 7), --sessions (one line per transcript), --dir PATH, --sonnet-ratio, --cap. Python 3.10+, no dependencies.

Havrin is building the rest: routing routine Claude Code steps to cheaper models and your own machine, with your tests checking every result. Join the beta at havrin.dev.

Metadata

Release files for havrin 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for havrin 0.2.0
File Size Uploaded Provenance
havrin-0.2.0.tar.gz 8.3 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for havrin 0.2.0
File Interpreter ABI Platform
havrin-0.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 17.9 kB

Release files / havrin-0.2.0.tar.gz

Download URL havrin-0.2.0.tar.gz
Size 8.3 kB
Tags Source
SHA-256 checksum
How to use checksums
f12df72596c937521b15e2c07b65d22720d9a610fdc3a031f4a2a95270156aa8
BLAKE2b-256 checksum
How to use checksums
52839b42c6a2d7b84298e022552e276687a49b079dac1dbb6c0e46130a04061f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.8

Release files / havrin-0.2.0-py3-none-any.whl

Download URL havrin-0.2.0-py3-none-any.whl
Size 9.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
89b56ce2c66ade8f3a9ca20f2fa651fcc19835d48f31fc39c422f419dc0b4010
BLAKE2b-256 checksum
How to use checksums
c70ba6597051db987f676e536ab18283ac85bac62bb10ac05ac4b4929479af77
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.8

Security for havrin 0.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files No provenance

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