| name | honey-compress |
| description | Rewrite a memory or context file (CLAUDE.md, AGENTS.md, a todo or notes file) into Honey-terse form so it costs fewer input tokens every session, without losing meaning. Backs up the original first. Use when asked to shrink or compress context files, trim CLAUDE.md, or cut per-session input cost. Prose only — never code, config, or data. |
| license | MIT |
Honey Compress
Apply Lever 2 to a file the agent re-reads every session. The cheapest token is the one not re-sent — a one-time rewrite that saves on every future load.
Do
- Back up first. Copy
FILE → FILE.original.md. If that backup already exists, stop and ask — never clobber a restore point. If no backup can be written, refuse.
- Rewrite the prose tersely — drop wind-up, hedging, narration, and redundancy; fragments over paragraphs; merge guidance that repeats.
- Preserve every distinct instruction — terser words, identical rules. If unsure whether a line changes behavior, keep it verbatim.
- Report original vs new line/byte count and the backup path.
Keep exact — never compress
- Code blocks, commands, paths, identifiers, versions.
- Any load-bearing directive — MUST/NEVER rules, and anything touching auth, secrets, money, migrations, or deletes. Compressing an instruction that changes behavior moves cost, it doesn't remove it.
Don't
- Don't touch code, config, or data files — prose context only.
- Don't merge two rules into one if they differ in effect.
- Don't compress a file you can't back up.
Boundaries
Reversible by design — FILE.original.md is the restore path. Verify the rewrite still carries every rule before reporting done.
