caveira

Caveira

Retime a git repository's history to fit a chosen time window — or fabricate a fresh one. Inspect who's in it first.

---

Caveira has three modes:

• Retime (default) — takes a repo plus a --start and --end, scores each commit's "difficulty" from its diff stats, draws a duration per commit, and produces a copy whose history fits inside the requested window — scaling and (if necessary) squashing commits to fit. Author and committer identities are preserved exactly; only timestamps change. Pass --preserve to keep every commit instead of squashing — new timestamps follow each commit's original chronological order and proportional spacing, compressed to fit the window. Pass --leeches N to also scatter authorship: the real commits, trees and messages are kept, but each commit's author is reassigned at random among N listed people plus the repo's original authors, so the history reads as collaborative.
• Fabricate (--fabricate) — synthesizes a brand-new commit history that ends at the source repo's exact HEAD tree.
• Interrogate (cav interrogate) — a read-only scan that reports the identities in a repo's history without modifying anything.

In retime and fabricate modes the original folder is renamed to .dead[.N] and the rewritten copy takes the original name.