> ## Documentation Index
> Fetch the complete documentation index at: https://docs.praison.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Checkpoints

> Shadow git checkpointing for file-level undo/restore

The `checkpoint` command manages file-level checkpoints using shadow git.

## Quick Start

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Save a checkpoint
praisonai checkpoint save "Before refactoring"
```

## Usage

### Save Checkpoint

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai checkpoint save "Checkpoint message"
```

**Expected Output:**

```
✅ Checkpoint saved: abc12345
   Message: Before refactoring
   Files changed: 3
```

### List Checkpoints

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai checkpoint list
```

**Expected Output:**

```
╭─ Checkpoints ────────────────────────────────────────────────────────────────╮
│  1. [abc12345] Before refactoring (2024-12-24 07:30:00)                     │
│  2. [def67890] Initial state (2024-12-24 07:25:00)                          │
╰──────────────────────────────────────────────────────────────────────────────╯
```

### Show Diff

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai checkpoint diff
praisonai checkpoint diff abc12345
praisonai checkpoint diff abc12345 def67890
```

### Restore Checkpoint

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai checkpoint restore abc12345
```

## Python API

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
import asyncio
from praisonaiagents.checkpoints import CheckpointService

async def main():
    service = CheckpointService(workspace_dir="/path/to/project")
    await service.initialize()
    
    # Save checkpoint
    result = await service.save("Before changes")
    print(f"Saved: {result.checkpoint.short_id}")
    
    # List checkpoints
    checkpoints = await service.list_checkpoints()
    for cp in checkpoints:
        print(f"{cp.short_id}: {cp.message}")
    
    # Restore
    await service.restore(result.checkpoint.id)

asyncio.run(main())
```

## See Also

* [Shadow Git Checkpointing Feature](/docs/features/checkpoints)