Skip to main content

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.

PyPI version Python 3.10+ License: MIT


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:

  1. Keep everything
  2. 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

rewind_ai-0.1.1.tar.gz (21.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

rewind_ai-0.1.1-py3-none-any.whl (20.8 kB view details)

Uploaded Python 3

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

Hashes for rewind_ai-0.1.1.tar.gz
Algorithm Hash digest
SHA256 cc00a43a4d58fba9fa034bf859fb7258b4752e7bd77251965716a059b292e0b0
MD5 88be6ed2f27a6dcf6551cff258a6b1eb
BLAKE2b-256 49b9c963138a4a71c38a4972bdc671f0a0ebbb7999272b7ad55fd9f22e04512f

See more details on using hashes here.

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

Hashes for rewind_ai-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 3f7749938247fa310ae44b45ad0423ec6d8fddb6baa2879868830e958163cb62
MD5 41d06dcecc1dab0e51fb0b0e5564bdf8
BLAKE2b-256 34e4fa325ac148264927361722860dc5a1b7e38d4cd6e2eb87c1371dd6f3bb13

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page