LucasSantana-Dev Checkpoint
Create a recoverable snapshot of in-progress work via git stash, tag, and optional remote push.
Usage
checkpoint
Stashes all uncommitted changes (including untracked files), creates a timestamped tag, and pushes to origin if remote exists. Output shows the stash ID and tag for recovery.
What It Does
- Runs
git stash push -u -m "checkpoint-<unix-ts>" - Creates
git tag checkpoint/<unix-ts>pointing to current HEAD - Attempts
git push origin refs/tags/checkpoint/<unix-ts>(silent if no remote) - Prints recovery commands for later use
Recovery
- From stash:
git stash apply stash@{0}orgit stash pop stash@{0} - From tag:
git checkout checkpoint/<unix-ts>(creates detached HEAD, safe to inspect) - List all checkpoints:
git tag -l "checkpoint/*"
Exit Conditions
- Success: "Checkpoint saved" + recovery command printed
- No git repo: Warns "not a git repo", exits with code 1
- Stash empty: Warns "no uncommitted changes", exits with code 0
- No remote: Tags locally only, no push attempt
- Push fails: Warns "remote push failed but local checkpoint saved"
- User abort: Ctrl+C exits cleanly, does not stash
Safety Notes
- Tags are lightweight, no additional refs needed
- Stash ID changes after git operations — use tags for stable recovery
- Tags persist even after
git gc - Useful alongside
context-savefor manual checkpoints between auto-saves