checkpointing

Track file edits and restore previous states via automatic checkpoints.

5|1|Updated Oct 30, 2025
One-click install
npx skills add https://github.com/reggiechan74/claude-plugins --skill checkpointing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: checkpointing
Source: https://github.com/reggiechan74/claude-plugins/tree/main/plugins/claude-code-metaskill/skills/checkpointing
Command: npx skills add https://github.com/reggiechan74/claude-plugins --skill checkpointing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Experimenting with code or getting stuck in a confusing conversation can lead to lost work or frustration. This Skill provides an automatic checkpointing system to easily revert changes, ensuring you can always recover and iterate safely.

Core Features & Use Cases

  • Automatic State Tracking: Every user prompt creates a new checkpoint, tracking file edits and creations for easy recovery.
  • Flexible Rewind Options: Revert conversation only, code only, or both to a previous state, giving you precise control over your session.
  • Use Cases: Safely test different implementation approaches, quickly recover from bugs, or reset a confusing conversation while keeping good code changes.
  • Use Case: You've made several changes and the code is broken. Press Esc twice, select a checkpoint from before the changes, and choose "Code Only" to instantly revert your files while keeping your conversation history.

Quick Start

Explain how to use the checkpointing system to rewind my code.

Frequently Asked Questions about checkpointing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I revert code changes to a previous state?

Rollback to earlier file states by selecting a checkpoint from your session history and choosing 'Code Only' mode to restore files while preserving conversation. Checkpoints are created automatically after each prompt, tracking all file edits and creations.

Can I undo changes while keeping my conversation history?

Yes. Checkpointing supports three restoration modes: revert conversation only, code only, or both. Select 'Code Only' to roll back file edits without losing your chat history and reasoning.

How does automatic checkpointing work in Claude Code sessions?

Each user prompt triggers a new checkpoint that tracks file edits and creations. The system stores checkpoints for 30 days by default, excludes bash commands and external edits, and enables you to restore to any saved state.

What happens if I test multiple implementation approaches and need to recover?

Rewind to a checkpoint before your experiments and select 'Code Only' to instantly revert all files to that state, preserving your conversation notes while discarding broken code changes.

Does checkpointing track changes made outside Claude Code?

No. Checkpointing only captures edits made through Claude Code's Edit and Write tools within a single session, excluding bash commands, external file modifications, and changes from concurrent sessions.

How long are checkpoints retained?

Checkpoints persist for a configurable default period of 30 days with automatic cleanup after expiration. You can adjust retention duration based on your session recovery needs.