# usagecut

> Scan your Claude Code setup and see exactly how many tokens you waste and where. By ClockedCode. Not affiliated with Anthropic.

Latest version **1.1.6** (published 2026-07-05) · MIT license · 0 weekly downloads

## Install

```sh
npm install usagecut
pnpm add usagecut
yarn add usagecut
bun add usagecut
```

Provides the command `usagecut`.

## Health

**Score 50/100 (C)** — status: active.

Positive: esm support; no vulnerabilities.

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 1.1.6 |
| Published | 2026-07-05 |
| First published | 2026-06-26 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM |
| Node | >=18 |
| Dependencies | 0 |
| Unpacked size | 167.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | ClockedCode |
| Maintainers | neozino |
| Keywords | claude, claude-code, tokens, usage, optimize |

## Links

- npm: https://www.npmjs.com/package/usagecut
- Repository: https://github.com/NeoZi12/usagecut-cli
- Homepage: https://www.usagecut.com
- Issues: https://github.com/NeoZi12/usagecut-cli/issues
- npm.io page: https://npm.io/package/usagecut

## Recent versions

- 1.1.6 (latest) — 2026-07-05
- 1.1.5 — 2026-07-03
- 1.1.4 — 2026-06-30
- 1.1.3 — 2026-06-30
- 1.1.2 — 2026-06-30
- 1.1.1 — 2026-06-30
- 1.1.0 — 2026-06-30
- 1.0.1 — 2026-06-26
- 1.0.0 — 2026-06-26

## README

<div align="center">

# UsageCut

### See exactly how many tokens you waste in Claude Code, and where. Then cut them.

[![npm](https://img.shields.io/npm/v/usagecut?color=c96442&label=npm)](https://www.npmjs.com/package/usagecut)
[![license](https://img.shields.io/badge/license-MIT-c96442)](./LICENSE)
[![runs locally](https://img.shields.io/badge/runs-100%25%20local-4f7a55)](#privacy)

```bash
npx usagecut
```

No install. No account. No API key. Runs entirely on your machine.

![UsageCut demo - npx usagecut scans your Claude Code setup, shows the waste, and cuts it](https://raw.githubusercontent.com/NeoZi12/usagecut-cli/main/assets/demo.gif)

</div>

---

`ccusage` tells you what you spent. **UsageCut shows you what you are wasting, and cuts it.**

Claude Code re-sends your whole conversation on every turn, so duplicate file
reads, idle MCP servers, and a bloated `CLAUDE.md` quietly tax every single
message, which is what drains your weekly limit faster than the work you
actually did. UsageCut reads your real session history, finds that waste, and
shows you a clean visual report of where it goes.

## What it does

- **Reads your Claude Code setup and session transcripts locally** - config,
  MCP servers, `CLAUDE.md`, and your `~/.claude` history.
- **Measures your waste** by replaying your own tool outputs through the exact
  shipped trimmer, so the number is measured, not estimated.
- **Finds the specific culprits**: idle MCP servers loaded into every session,
  oversized always-loaded instructions, and the same files read again and again.
- **Renders a visual report** with a setup grade, where your tokens go, and how
  you rank against other developers scanned so far.
- **Optimizes it for you, for free** - disable idle servers, slim and re-scope
  `CLAUDE.md`, and install a lossless live trimmer. Every change is backed up,
  diffed, and reversible with one command.

## Usage

```bash
npx usagecut          # scan your setup and open your visual web report
npx usagecut --json   # print the raw aggregate payload, no upload

npx usagecut apply    # apply the free optimizations (backed up + reversible)
npx usagecut status   # show what is currently applied
npx usagecut revert   # undo every change, restoring your original setup
```

## Privacy

Your raw code, prompts, and logs **never leave your machine**. The scan runs
locally and uploads **only aggregate counts** - numbers and one-letter grades -
to render your web report. Nothing else is transmitted, and there is no account
to create. The scanner is open source, so you can read exactly what it does
before you run it.

## How it cuts tokens

UsageCut is lossless by design. It never makes Claude dumber and never reroutes
your API key or your code. The levers:

- **Live trimmer** - a local hook that losslessly shrinks bulky, repeated tool
  output as it appears (collapses duplicate reads, strips junk). The big one.
- **Disable idle MCP servers** - detected from your real transcripts, including
  sub-agent transcripts, so a server is only flagged when it was truly never called.
- **Slim `CLAUDE.md`** - trim and re-scope always-loaded instructions, kept
  verbatim, so they only load where they are actually needed.

Honest about the numbers: setup fixes alone are a modest cut; the live trimmer
is where most of the savings live on token-heavy sessions. The free scan
measures *your* real sessions and shows *your* number - no billboard percentages.

## Options and environment

- `--json` - print the raw aggregate payload instead of uploading.
- `USAGECUT_API_URL` - override the report endpoint (defaults to `https://www.usagecut.com`).
- `USAGECUT_TOKEN` - claim token from the website scan page, so that page shows
  your scan automatically.

## About

UsageCut is a free tool by [ClockedCode](https://clockedcode.com). It is free
because it is genuinely useful on its own - if you want to push Claude Code much
further, that is what ClockedCode is for.

**Not affiliated with Anthropic.** "Claude" and "Claude Code" are trademarks of
Anthropic.

## License

MIT. See [LICENSE](./LICENSE).

---
_Source: https://npm.io/package/usagecut · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._