sage-checkpoint-system

Capture state snapshots, file changes, and session context for rollback.

12|1|Updated Jul 15, 2025
One-click install
npx skills add https://github.com/majiayu000/sage --skill sage-checkpoint-system
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sage-checkpoint-system
Source: https://github.com/majiayu000/sage/tree/main/.sage/skills/sage-checkpoint-system
Command: npx skills add https://github.com/majiayu000/sage --skill sage-checkpoint-system

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Sage's checkpoint system provides deterministic state capture and safe recovery to support undo/rollback in long-running tasks. It enables reproducible experiments and safe transactional operations by saving comprehensive state, file changes, and conversation context to allow precise restoration.

Core Features & Use Cases

  • State snapshots: capture complete execution state for safe restoration.
  • File tracking: monitor and restore file changes across checkpoints.
  • Diff and rollback: compute diffs and rollback to a chosen checkpoint.
  • Session and tool integration: manage per-session and tool-execution checkpoints for reliable workflows.
  • Use Case: before applying risky config changes, create a checkpoint, perform changes, and revert if needed.

Quick Start

Create a manual checkpoint: sage checkpoint create --type Manual --description 'Before risky update'.

Frequently Asked Questions about sage-checkpoint-system

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

FAQPage Schema
How do I create a state snapshot before making risky configuration changes?

State snapshots capture complete execution state for safe restoration by recording file changes and session context. They enable deterministic recovery, allowing you to revert code changes and configurations to a previous checkpoint.

How do I roll back file changes to a previous checkpoint?

To roll back file changes, the system computes diffs against a chosen checkpoint and applies restoration. It monitors file states across checkpoints, allowing selective restoration of code and configuration changes.

Can I use checkpoint-based rollback for transactional safety in development workflows?

Yes, you can use checkpoint-based rollback for transactional safety in development workflows. It captures comprehensive state and session context, ensuring safe experimentation by allowing precise restoration across code changes and configurations.

What's the best way to track file states across multiple code changes during development?

The best way to track file states across code changes is using a file-tracking checkpoint system that monitors modifications per session. It integrates with tool execution to manage states and compute diffs for reliable workflows.

When do I need a state snapshot for undo capabilities in long-running tasks?

You need a state snapshot for undo capabilities in long-running tasks when executing risky updates or experiments. It provides deterministic state capture and safe recovery to support reproducible operations.