| name | attachments |
| description | Compress heavy context before it costs tokens. Use when the user attaches or asks to read a PDF, scanned document, screenshot/large image, or a verbose log / build output / CI output — convert PDFs to Markdown, compress oversized images, and digest noisy logs so the same content costs a fraction of the tokens. |
attachments — PDF / image / log compression (a jusTokenMax module)
The silent token sinks in a session are the heavy things you feed in: PDFs
(ingested as ~1,500-token page images per page), oversized screenshots, and
verbose logs (thousands of near-identical lines). justokenmax turns each into a
cheap, faithful equivalent.
When to use
- A
.pdf whose contents are needed → PDF → page-delimited Markdown.
- A
.png/.jpg/.jpeg/.webp over a couple hundred KB → downscale ≤1568px +
recompress + strip metadata.
- A
.log or pasted build/test/CI output that's long and repetitive →
digest: ANSI stripped, repeated lines collapsed (×N), stack traces
folded, errors/warnings + head/tail kept.
The Read hook does the common case automatically — a Read on a .pdf, large
image, or .log is transparently rewritten to read the cheap artifact. Use this
skill for manual/batch runs and to report savings.
How to run
justokenmax optimize spec.pdf screenshot.png build.log # auto-dispatch by type
justokenmax pdf report.pdf # force PDF → Markdown
justokenmax image diagram.png --max-edge 1280 # force image compression
justokenmax logs ci-output.log # force log digest
justokenmax stats # lifetime token savings
Add --json for machine-readable output. If justokenmax isn't on PATH, use
python3 -m justokenmax <args> with the plugin's python/ dir on PYTHONPATH.
After optimizing
Read the optimized artifact the command reports (.md, .log.txt, or the
compressed image), not the original. Everything is cached by content hash, so
re-running on an unchanged file is free and reversible — the original is one
read away.
Limits
- No OCR: scanned/image-only PDFs have no text layer → empty Markdown; read the
original instead.
- Tiny images/logs are skipped (already cheap).
