Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Browser & automation

ac-checkpoint-manager

Manage checkpoints for rollback capability. Use when creating save points, rolling back changes, managing recovery points, or restoring previous states.

majiayu000 · AI review on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add majiayu000/claude-skill-registry --skill ac-checkpoint-manager

About this skill


name: ac-checkpoint-manager description: Manage checkpoints for rollback capability. Use when creating save points, rolling back changes, managing recovery points, or restoring previous states.

AC Checkpoint Manager

Manage checkpoints for safe rollback during autonomous development.

Purpose

Creates and manages checkpoints that enable rollback to known-good states, providing safety during autonomous operation.

Quick Start

from scripts.checkpoint_manager import CheckpointManager

manager = CheckpointManager(project_dir)
checkpoint = await manager.create_checkpoint("before-refactor")
await manager.restore_checkpoint(checkpoint.id)

Checkpoint Types

  • Auto: Created automatically at key points
  • Manual: Created on explicit request
  • Feature: Created after each feature completion
  • Session: Created at session boundaries

Checkpoint Structure

.claude/checkpoints/
├── checkpoint-20240115-100000/
│   ├── metadata.json
│   ├── feature_list.json
│   ├── execution-state.json
│   └── git-ref.txt
├── checkpoint-20240115-110000/
│   └── ...

Auto-Checkpoint Points

  • Before starting new feature
  • After completing feature
  • Before risky operations
  • At context compaction

Workflow

1. CREATE    → Snapshot current state
2. STORE     → Save files and git ref
3. VALIDATE  → Verify checkpoint integrity
4. (on rollback)
5. RESTORE   → Restore from checkpoint
6. VERIFY    → Confirm restoration

Integration

  • Used by: ac-state-tracker for state recovery
  • Used by: ac-task-executor before risky operations

API Reference

See scripts/checkpoint_manager.py for full implementation.