KeepSafe

This extension runs your local checkpoint CLI from VS Code to help you recover from AI-driven code mistakes.

Commands

• KeepSafe: Quick Checkpoint
• KeepSafe: Restore Latest Checkpoint
• KeepSafe: Create Checkpoint
• KeepSafe: List Checkpoints
• KeepSafe: Restore Checkpoint
• KeepSafe: Diff Checkpoints
• KeepSafe: Rebuild Metadata
• KeepSafe: Add Ignore Pattern

Fast Recovery Workflow

1. Run KeepSafe: Quick Checkpoint before risky AI-generated edits.
2. If changes damage the workspace, run KeepSafe: Restore Latest Checkpoint.
3. For older recovery points, use KeepSafe: Restore Checkpoint and pick from history.

Behavior details:

• KeepSafe: Quick Checkpoint auto-generates checkpoint names as quick-YYYYMMDD-HHMMSS.
• KeepSafe: Restore Latest Checkpoint restores the newest available checkpoint after a confirmation prompt.

Configuration

Set keepsafe.command if keepsafe is not on your PATH.

Examples:

• keepsafe
• C:/workspace/keepsafe/.venv/Scripts/keepsafe.exe

Development

1. Run npm install.
2. Run npm run compile.
3. Press F5 in VS Code to launch Extension Development Host.