checkpoints

AI Agent Checkpoints Module for PraisonAI Agents. Provides file-level checkpointing using a shadow git repository to track and restore file changes made by agents. This enables:

Automatic checkpointing before file modifications
Rewind to any previous checkpoint
Diff between checkpoints
Restore files and conversation state together

Zero Performance Impact:

All imports are lazy loaded via getattr
Checkpoints only created when enabled
No overhead when checkpoints are disabled

Usage:

from praisonaiagents.checkpoints import CheckpointService

# Create checkpoint service
service = CheckpointService(
    workspace_dir="/path/to/project",
    storage_dir="~/.praisonai/checkpoints"
)

# Initialize shadow git
await service.initialize()

# Save a checkpoint
checkpoint_id = await service.save("Before refactoring")

# Restore to a checkpoint
await service.restore(checkpoint_id)

# Get diff between checkpoints
diff = await service.diff(from_id, to_id)

Import

from praisonaiagents import checkpoints