caveman-compress

To compress markdown prose and save tokens without losing code blocks and links, this tool shortens text into a concise caveman form while preserving all technical facts, URLs, and structural headings. It provides a diff and token delta before overwriting your file.

Compressing notes in place does overwrite original files, but only after you explicitly confirm. The tool shows a diff and token delta and requires user confirmation before writing the compressed caveman version back to the source file.

You can compress memory notes, untracked scratch files, or files explicitly overridden by the user. The tool applies scoped compression to these targets, maintaining frontmatter, headings, and log structure intact.

Caveman compression preserves technical fidelity by keeping every code block, URL, and structural heading intact while shortening the surrounding prose. It ensures no technical facts are lost during the text compression process.

Yes, you can review changes before a file is compressed. The tool reports a diff and token delta showing exactly what will change, requiring your confirmation before any in-place overwriting occurs.