- Home
- Skills
- Productivity
- Agent Checkpoint
More screenshots
Works with the AI Agents you already use
Agent Checkpoint
An undo button for AI agent work: save the project before a risky change, see exactly what changed, roll back in one command.
Free
Agent Checkpoint
Example session with this skill installed
Refactor the payments module to support a second provider. Save a checkpoint first so we can go back if it gets messy.
- Read your context and instructions
- Compiled the agent checkpoint
Checkpoint saved, refactor done, and an easy way back
Before touching anything
$ checkpoint.py save -m "before the payments refactor"
Checkpoint 1 saved (git): before the payments refactor
After the refactor, here is exactly what changed:
$ checkpoint.py diff
Since checkpoint 1 (before the payments refactor): 4 modified, 1 added, 2 deleted
M src/index.ts
D src/orders/draft.ts
D src/orders/routes.ts
M src/orders/service.ts
A src/payments/providers/index.ts
M src/payments/refunds.ts
M src/payments/stripe.ts
The two deletions in src/orders/ were not part of the plan (a codemod I ran matched too broadly), so I rolled those back only:
$ checkpoint.py restore 1 --path src/orders/draft.ts --path src/orders/routes.ts
Restored checkpoint 1 (before the payments refactor) (src/orders/draft.ts, src/orders/routes.ts): 2 added
A src/orders/draft.ts
A src/orders/routes.ts
The state before this restore is saved as checkpoint 2. Undo with: checkpoint.py restore 2
Your branch, HEAD and staging area were not touched; 'git status' shows the restored files as changes.
If you want to drop the whole refactor
checkpoint.py restore 1 puts the project back exactly as it was, and restore 2 would bring the refactor back.
Connects securely to your tools. The creator never sees your data.
About this skill
What it does
One script, checkpoint.py, that gives any project an undo button for agent work:
checkpoint.py save -m "before the payments refactor"
checkpoint.py diff --patch
checkpoint.py restore 1 --dry-run
checkpoint.py restore 1
Why next to git and /rewind
- Claude Code's
/rewindtracks edits made with Claude's file tools. It does not track files changed by Bash commands (rm,mv,sed -i, generators,npm install, formatters), by background subagents, or by other tools. - Asking an agent to commit or stash before every risky step pollutes history, and
stash/checkout/resetare exactly the commands that lose uncommitted work when they go wrong.
Safe by design
- Inside git: checkpoints are commits under
refs/checkpoints/, built with a private index. Your branch, HEAD, staging area and stash are never touched, and checkpoints are never pushed. - Outside git: deduplicated content-addressed copies in
.agent-checkpoints/. - Every restore is undoable: it checkpoints the current state first.
- Never loses what it did not save: files that are ignored, too large, or inside nested repositories and submodules are left alone.
- Byte-exact: line endings, modes and symlinks come back as saved.
- Optional Claude Code hook that checkpoints before Bash commands that can change files and before subagents start, merged into your existing settings with a backup.
Python 3.8+, standard library only. 79 automated tests, including regressions for every issue found in a pre-release review.
Built by Nex AI, nex-ai.be
Not a backup: checkpoints live on the same disk. Submodule and nested repository contents, ignored files and files over the size limit (default 50 MB) are not captured. Byte-exact line endings need git 2.40 or newer. Recreating symlinks on Windows needs Developer Mode or admin rights.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
1 use
Times used to date
Free forever
No account required to browse
Trust & safety
Security scan
Security scan passed 29 days ago
- Free with an Agensi account
Requires
Permissions
Terminal to run checkpoint.py and git. Read/write files to save checkpoints and restore them inside the project. install-hook (optional, only when the user asks) writes .claude/settings.local.json, or ~/.claude/settings.json with --global, after a backup. No network.