cyberspezie/Token-Saver

A plugin for Claude Code that saves tokens. Your computer does the heavy reading locally and for free: text recognition, face detection, video scene sheets, file search and file outlines. Claude then reads a one-page summary and at most two images, instead of every screenshot, video frame or long file.
It works silently. There is no status line and no pop-ups: it only changes what Claude reads.
| Without it | With it |
| 6 page screenshots to check a layout: ~6,000 tokens | 1 summary (overflow, broken images, tiny text) + 1 sheet: ~1,700 tokens |
| 12 frames of a 3-minute video: ~15,000 tokens | 1 sheet with one frame per scene + cut list: ~1,700 tokens |
| A 5,500-line HTML file read whole: ~99,000 tokens | A one-page outline: ~1,000 tokens |
| grep hitting a minified CSS line: ~6,000 tokens | The same line clipped: ~70 tokens |
## Install
At the prompt of a Claude Code terminal session:
/plugin install token-saver --marketplace cyberspezie/Token-Saver
Answer y to add the marketplace, then pick the user scope so it works in every project.
From a shell:
claude plugin install token-saver --marketplace cyberspezie/Token-Saver
In the Claude desktop app, where /plugin does not run: click + next to the prompt box, then Plugins, Add marketplace with cyberspezie/Token-Saver, then Add plugin.
## What it does inside Claude Code
Before Claude reads a heavy file, it suggests the local prep step once: an image (a screenshot gets OCR), a video (it gets a scene sheet), or a text file over 60 KB read whole (it gets an outline). If Claude reads the same file again, the read goes through.
Long lines in shell output (minified CSS, JSON) are clipped to 240 characters. Put TOKPREPRAW=1 in a command to get its full output.
A find over the whole home folder is pointed to the system's search index (Spotlight, Windows Search) instead.
Media jobs: when Claude makes an asset for you (a video edit, a cutout, a gif), its temporary files go in one job folder. Once you approve the final version, they are deleted and the conversation is compacted, which frees both disk space and context.
A skill tells Claude which command fits which task.
Code navigation through graphify. The first session after the plugin is installed sets graphify up in the background (uv tool install graphifyy, else pipx, else pip --user) and registers its Claude Code skill. Claude then queries the project's knowledge graph (graphify query, path, explain) before grepping or reading source files, and runs graphify update . after code edits. Build a graph once per project with /graphify .. Once graphify is ready the plugin remembers it and never checks again; a failed install is retried after a day, or at once with tokprep graphify setup --force.
## The tokprep commands
Claude runs these itself; you don't need to.
| Command | What it does locally | What Claude reads |
| tokprep ocr | text recognition | the text |
| tokprep faces | face boxes and capture quality | one line per image + a sheet of face crops |
| tokprep media | size, text, faces, people, scene changes, transcript (macOS 26+) | summary + 1–2 contact sheets |
| tokprep scenes | one frame per scene change (flashes merged), cut list, shot lengths | summary + 1 sheet |