compress

To reduce token usage in memory files, you compress natural language markdown into caveman format. This shrinks file content to speed up sessions while preserving essential structure and references like headings and URLs.

Yes, compressing CLAUDE.md files preserves code blocks, file paths, URLs, and headings. The tool compresses prose into caveman format while satisfying strict requirements to maintain the original document's structural elements and references.

To compress a markdown memory file, run the compress command on your target filepath. The tool automatically creates a backup of the original as FILE.original.md and overwrites the active file with the compressed version.

Caveman format is a compressed syntax for natural language memory files that reduces input tokens. It transforms verbose prose into shortened phrases while preserving essential content, headings, and structure for Claude sessions.

Yes, you can validate and fix issues after compressing a memory file. The tool supports a retry and fix workflow by validating the compressed output and optionally repairing issues using Claude.

You should avoid markdown compression when your memory file relies heavily on verbose natural language context that cannot afford loss of descriptive nuance. Compression prioritizes token reduction over preserving detailed prose explanations.