Use cases

regit excels in these scenarios. Each page shows a complete working example with a step-by-step walkthrough, the exact output to expect, and common variations. All of them follow the same rhythm: run the command to preview, inspect the plan, then re-run with --execute to apply — with a backup ref and regit undo behind you.

• Spread same-day commits — an AI-assisted burst left 30 commits stamped today; spread them over past weeks with redate
• Split an oversized commit — one giant commit mixing refactor, feature, and tests becomes 2–4 semantic commits via split and an LLM
• Polish commit messages — pre-push cleanup with reword, squash, retitle, and drop-bodies
• Remove secrets and files from history — purge an accidentally tracked build directory and redact a leaked API key with purge and redact

Related pages

• Getting started — install and first run
• CLI reference — every command and flag
• Data flow — the preview/execute convention and the guarded apply protocol