eurysx
Local-first usage observability for Claude Code, OpenCode, Pi, and Codex.
Eurysx reads local agent history and reports tokens, requests, turns, tool calls, estimated or recorded cost, and pricing provenance. It does not upload usage data or persist prompts, responses, file contents, tool arguments, or tool results.
Eurysx v0.1.4 is a local CLI, not a hosted service.
What the name means
Eurysx is derived from Euryphaessa, an epithet associated with broad-shining light. Its eury root suggests a wide view; s evokes stats or sight, and x marks cross-agent work. It is a compact name for seeing usage across coding harnesses without pretending that their routes, prices, or records are interchangeable.
Our philosophy
- Local history is evidence, not telemetry: usage stays on the machine and sensitive session content is neither persisted nor reported.
- Unknown stays unknown. Eurysx does not invent a price, provider route, or billing mode when the available records cannot support one.
- Recorded cost wins over policy. Configurations make user intent explicit; they do not rewrite what a harness recorded.
- One normalized view should preserve provenance. Comparable reports must still show where data and pricing came from.
- The tool remains a small, local CLI, not a hosted analytics service or an agent-management platform.
Install
pip3 install eurysx
eurysx --help
Run
eurysx --version
eurysx
eurysx --agent codex --days 30
eurysx --agent all --month 2026-08
eurysx --agent pi --from 2026-08-01 --to 2026-08-15
eurysx --agent all --days 30 --output reports/usage.json
eurysx --agent all --days 30 --format html
eurysx --agent all --days 30 --output reports/august-usage --format html
eurysx --refresh-pricing
eurysx collect --agent codex
eurysx report --agent codex --days 30
eurysx doctor
reports/ is ignored by Git. eurysx collects current local metadata and then reports it. collect stores metadata only; report reads the local store without collecting. doctor is terminal-only and reports local harness, source, pricing-cache, and configuration health without parsing history, refreshing prices, or deleting retained data.
Period selectors are mutually exclusive: --days N, --weeks N, --from YYYY-MM-DD [--to YYYY-MM-DD], --month YYYY-MM, --quarter YYYY-QN, --year YYYY, and --ytd. Rolling periods include today. Filter selectors --model, --provider, and --billing-mode combine with agent and period selectors.
Documentation
The User manual is the authoritative command, output, configuration, pricing, and diagnostics reference.
Current limits
- Claude Code's stats cache is aggregate-only; selected date ranges exclude it and report a scope warning.
- The supported collectors are Claude Code, OpenCode, Pi, and Codex only.
- Pricing data is metadata only. Source pricing may be unavailable, in which case the relevant cost remains unknown.
- Preferences use recorded route metadata or exact user rules. Eurysx does not call LiteLLM or provider APIs for route discovery and never reads credentials.
- API-equivalent estimates are opt-in, never invoices or budget spend. All report formats distinguish them from harness-recorded cost; see the User manual for the JSON fields and
N/Abehavior.
Development
PYTHONPATH=src python3 -m unittest -v tests/test_eurysx.py
python3 -m py_compile src/eurysx/*.py
Sanitized collector fixtures cover Claude Code, Codex, Pi, and OpenCode. The OpenCode SQL fixture builds a temporary SQLite database during the test rather than committing a binary database file.
Metadata
Release files for eurysx 0.1.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| eurysx-0.1.4.tar.gz | 64.9 kB | With provenance | Details for eurysx-0.1.4.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| eurysx-0.1.4-py3-none-any.whl | Python 3 | none | any | Details for eurysx-0.1.4-py3-none-any.whl |
Total release size: 110.5 kB
Release files / eurysx-0.1.4.tar.gz
| Download URL | eurysx-0.1.4.tar.gz |
|---|---|
| Size | 64.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
223c44894bea76b8571c2ac291bc1d42a7b90e3e13ed88d634b64fb6154192a5
|
|
BLAKE2b-256 checksum How to use checksums |
2588d4857e96c3dcfeb2c388378b9a9cc4a587215e1c96d47fc0aa5734e9261d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 17, 2026.
Transparency logRelease files / eurysx-0.1.4-py3-none-any.whl
| Download URL | eurysx-0.1.4-py3-none-any.whl |
|---|---|
| Size | 45.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
cfa6534c91d59d9b2bef9bcd697f3b10e2c2902b77583ff40053fa52584264c8
|
|
BLAKE2b-256 checksum How to use checksums |
facefdb03f58a0c1814d9de74126f3a8fd1fc9cb7a73c44710ce494e1caf852e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 17, 2026.
Transparency logSecurity for eurysx 0.1.4
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.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for eurysx-0.1.4.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 17, 2026.
Transparency logA 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.