Caveman Compress

Purpose

Compress docs and natural language files such as AGENTS.md, todos, preferences, and repo notes into caveman-speak to reduce input tokens. Work directly in the active Codex session. Do not create backup files by default.

Trigger

/caveman:compress <filepath> or when the user asks to compress a memory file.

Discovery

• Inspect current repo first when the user does not name files.
• Use git status --porcelain and git diff --name-only to find changed files.
• Use rg and find for nearby docs, plus bounded semantic matching for likely prose neighbors.
• Prefer repo-owned docs and notes by default. Allow explicit outside-repo paths when named.
• Use request_user_input for ambiguous or lower-confidence candidates and include scored recommendations.

Process