Checkpoints

Checkpoints automatically save your project state before the Agent makes changes. If something goes wrong, you can instantly restore to exactly how things were—like time travel for your code.

How Checkpoints Work

Every time you send a message to the Agent, Sidekick automatically creates a checkpoint of your entire project:

You send a message
        ↓
Checkpoint created (snapshot of all files)
        ↓
Agent makes changes
        ↓
Something went wrong?
        ↓
Click restore → Project reverts to checkpoint

Checkpoints are created automatically—you don't need to do anything. They happen before every Agent interaction.

Restoring a Checkpoint

Find the Message

Scroll to the message you want to restore to in the chat history.

Hover to Reveal Restore Button

Hover over any user message (your messages, not the Agent's). A restore icon appears.

Click Restore

Click the rotate arrow icon. A confirmation dialog appears.

Confirm Restoration

The dialog explains what will happen:

All current files will be replaced
Files created after this point will be deleted
Protected files (.git, .env) are preserved

Click Confirm to restore.

Project Restored

Your project returns to exactly how it was when you sent that message. All messages after this point are also removed from the conversation.

Restoration is permanent. Files created after the checkpoint will be deleted. Make sure you don't need any recent changes before restoring.

What Gets Saved

Each checkpoint captures:

Included	Excluded
All source code files	`node_modules/`
Configuration files	`build/`, `dist/`, `target/`
Assets and resources	`.git/` directory
Any file in your project	Files in `.gitignore`
	Files in `.sidekickignore`
	Log files, temp files

Protected Files

These files are never deleted during restoration, even if they weren't in the checkpoint:

.git/ — Your git history is safe
.env — Environment variables preserved
.env.* — All environment file variants

Retention Limits

Limit	Value
Maximum per project	50 checkpoints
Auto-cleanup age	7 days
Minimum free disk	100 MB

When limits are reached:

Oldest checkpoints are automatically deleted
You'll always have recent checkpoints available
Critical disk space triggers cleanup

On this page