Automatic session checkpoints for AI coding agents. Undo just what went wrong.
Project description
⏪ Rewind
An undo button for AI coding agents.
Rewind watches your repository, automatically creates checkpoints whenever an AI agent starts making changes, and lets you instantly roll back to any point in the session. No commits, no branch switching, no lost work—just one command to get back to the last good state.
Your AI coding agent just destroyed 14 files.
Get back to the last good state in one command.
AI coding agents are incredible.
Until they aren't.
You ask Claude Code to add authentication.
Ten minutes later:
- 14 files changed
- Half the changes are brilliant
- The other half are a disaster
- You have absolutely no idea where things went wrong
Now what?
git checkout .
Congratulations. You just deleted the 10 minutes of good work too.
Or you can spend the next hour manually undoing files.
Or ask the agent to undo itself and hope it doesn't make things worse.
There should be a better option.
Rewind creates automatic checkpoints while your AI agent works, so you can jump back to any moment of the session instantly.
rewind jump 2
Done.
Your git history stays clean.
Your branch stays untouched.
Only the bad changes disappear.
Why Rewind Exists
Git was built for humans.
AI agents don't behave like humans.
Humans:
- Edit one file at a time
- Make deliberate changes
- Commit intentionally
AI agents:
- Touch dozens of files in seconds
- Refactor entire systems at once
- Occasionally decide working code needs "improvement"
When an AI agent goes off the rails, Git gives you two choices:
- Keep everything
- Lose everything
Rewind gives you a third option:
Keep the good work. Remove the bad work.
See It In Action
You tell Claude Code:
Add authentication to my application.
A few minutes later:
rewind list
Session checkpoints
# Time Description
4 1m ago Modified middleware and routes
3 4m ago Updated auth implementation
2 8m ago Added authentication module
1 12m ago Updated package dependencies
0 14m ago Initial state
Something broke after checkpoint 2.
Inspect exactly what changed:
rewind diff 3
Restore the last known good state:
rewind jump 2
Your commits remain untouched.
Your branch remains untouched.
Your work remains intact.
Installation
pip install rewind-ai
Start the watcher:
rewind watch &
That's it.
Rewind now silently watches your repository and automatically creates checkpoints whenever an AI agent starts making significant changes.
No setup.
No configuration.
No cloud account.
How It Works
Rewind monitors filesystem activity and detects write bursts—the characteristic pattern of AI coding agents modifying multiple files in rapid succession.
When a burst is detected, Rewind creates a lightweight checkpoint of your working tree.
These checkpoints:
- Don't create commits
- Don't clutter your git history
- Don't touch your branch
- Don't require any action from you
They're simply there when you need them.
Works With Every AI Coding Agent
Because Rewind watches filesystem activity rather than integrating with specific tools, it works with virtually anything:
- Claude Code
- Cursor
- GitHub Copilot
- Aider
- OpenHands
- Devin
- Gemini CLI
- Any custom coding agent
If it writes files, Rewind can protect you from it.
Commands
Start Watching
rewind watch
Stop Watching
rewind stop
Check Status
rewind status
Create Manual Checkpoint
rewind snap
View Checkpoints
rewind list
Inspect Changes
rewind diff 4
Restore Previous State
rewind jump 4
Create Branch From Checkpoint
rewind branch 4
Remove Checkpoints
rewind clear
Why Not Just Commit More Often?
Frequent commits help.
But they don't solve this problem.
- Commits clutter history with half-finished work
- You still can't restore to moments between commits
- You have to remember to create them
- They weren't designed for autonomous agents modifying dozens of files at once
Rewind is automatic.
It works while you're thinking about your code—not your version control strategy.
Privacy
Everything runs locally.
- No telemetry
- No analytics
- No cloud sync
- No network requests
Your code never leaves your machine.
The Future of AI Coding Needs a Better Undo Button
AI coding agents are becoming more powerful every month.
They're writing more code, touching more files, and making bigger changes than ever before.
The better they get, the more important safe rollback becomes.
Rewind isn't a replacement for Git.
It's the missing layer between "everything is fine" and "what just happened to my repository?"
Contributing
git clone https://github.com/dakshgulecha/rewind-ai
cd rewind-ai
pip install -e ".[dev]"
pytest
Issues and pull requests are welcome.
License
MIT
If Rewind saves you even once, consider giving the project a star.
⭐ It helps more developers discover it before their AI agent decides to refactor the entire codebase.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file rewind_ai-0.1.1.tar.gz.
File metadata
- Download URL: rewind_ai-0.1.1.tar.gz
- Upload date:
- Size: 21.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cc00a43a4d58fba9fa034bf859fb7258b4752e7bd77251965716a059b292e0b0
|
|
| MD5 |
88be6ed2f27a6dcf6551cff258a6b1eb
|
|
| BLAKE2b-256 |
49b9c963138a4a71c38a4972bdc671f0a0ebbb7999272b7ad55fd9f22e04512f
|
File details
Details for the file rewind_ai-0.1.1-py3-none-any.whl.
File metadata
- Download URL: rewind_ai-0.1.1-py3-none-any.whl
- Upload date:
- Size: 20.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3f7749938247fa310ae44b45ad0423ec6d8fddb6baa2879868830e958163cb62
|
|
| MD5 |
41d06dcecc1dab0e51fb0b0e5564bdf8
|
|
| BLAKE2b-256 |
34e4fa325ac148264927361722860dc5a1b7e38d4cd6e2eb87c1371dd6f3bb13
|