SessionCost
See where every token of your AI coding chat went, and what to fix to send fewer.
Every message you send makes the agent send the whole chat again. SessionCost shows each turn on one path, the calls inside it, and the fixes that would have sent less, measured from your own chat.
Tokens: exact, from the agent's own log. Money: an estimate at list prices; your bill may differ (plan, contract rates, batch, cloud provider). Cursor and Copilot Chat keep no token counts, so for them tokens are estimated from the size of the text.
📖 Help and guides · ▶ Take the report tour · 1-minute video · pictures use a made-up demo chat
Install
One line adds /sessioncost to every agent on your computer: Claude Code, Codex, Cursor and Antigravity. It needs
neither Python nor Git. Open a terminal, paste the line for your computer, and press Enter:
| Windows (PowerShell) | irm https://raw.githubusercontent.com/kish21/sessioncost/main/install.ps1 | iex |
|---|---|
| Mac / Linux | curl -fsSL https://raw.githubusercontent.com/kish21/sessioncost/main/install.sh | sh |
It ends with /sessioncost added for each agent it found. Then restart your agent.
Prefer PyPI (python -m pip install -U sessioncost, then python -m sessioncost setup), npm (npx sessioncost,
then npx sessioncost setup) or your agent's plugin list
(Claude Code: /plugin marketplace add kish21/sessioncost)? Every way, step by step:
Install SessionCost.
Use it
Open any chat and type /sessioncost (or ask: "run sessioncost"). The report opens in your browser.
How much was sent, and how much the fixes would cut
What to fix: each fix with its saving and the rule to paste to your agent.
New to the report? Your first report walks through it in five minutes, and every section of the report has a ? that opens its help page.
Commands
| In a chat | What it does |
|---|---|
/sessioncost |
Builds the report of this chat and gives you its link |
/sessioncost clean |
Deletes old reports, keeps the latest |
/sessioncost update |
Updates SessionCost, then restart your agent |
/sessioncost version |
Shows which SessionCost version this agent uses |
/livesession |
Claude Code: the guard checks each step before it runs, blocks the dangerous ones and asks before the risky ones, in every chat until /livesession off |
Terminal commands, report options and the guard's settings: Commands.
Private
- Reads your agent's log on your computer. No AI model is called.
- Nothing is sent anywhere: the report is one file on your computer.
More: Privacy and security.
More
- Which agents, and how exact
- How the money is counted
- Fix a problem, including updating
MIT license · made by kish21
1 maintainer
Metadata
1 maintainer
Release files for sessioncost 1.0.0
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 |
|---|---|---|---|---|
| sessioncost-1.0.0.tar.gz | 261.6 kB | Without provenance | Details for sessioncost-1.0.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| sessioncost-1.0.0-py3-none-any.whl | Python 3 | none | any | Details for sessioncost-1.0.0-py3-none-any.whl |
Total release size: 540.0 kB
Release files / sessioncost-1.0.0.tar.gz
| Download URL | sessioncost-1.0.0.tar.gz |
|---|---|
| Size | 261.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
082462eb38706d357f247aa405028991624a10a52d40cb6c37c3d7e7cba3de95
|
|
BLAKE2b-256 checksum How to use checksums |
381092acc5cd263f2cbdc2f4b58a5aa698ed20a508639e1acbadf6d62fec4b4e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.16 {"installer":{"name":"uv","version":"0.12.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / sessioncost-1.0.0-py3-none-any.whl
| Download URL | sessioncost-1.0.0-py3-none-any.whl |
|---|---|
| Size | 278.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0c9b7f9de3e26142ec5f03e90c529110f245481055db11560ce579f12be5dd04
|
|
BLAKE2b-256 checksum How to use checksums |
6e25e855d2200ee00513efe005abcdc1227f4bc5b74ca58c354efb913b0b49c0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.16 {"installer":{"name":"uv","version":"0.12.16","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for sessioncost 1.0.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.
