Checkpoints and Git

Checkpoints-and-Git

Workspace checkpointing and shadow-repo Git flows for previewing, restoring, and committing changes.

Shadow repos

Git checkpoints are backed by shadow repositories. The engine opens or initializes a per-workspace shadow repo, stages tracked changes, and records checkpoint state without mutating the user’s main repository.

Workspace checkpoints

Checkpoint flows support preview and restore:

• preview shows the checkpointed changes before restoring
• restore re-applies the saved workspace state

The implementation is workspace-scoped and uses checkpoint metadata to match the correct root.

Commit message generation

The engine can generate commit messages from diffs. The commit-message endpoint accepts a diff and an optional prompt text, then returns a plain-text commit message.

HTTP endpoints

Git and checkpoint HTTP endpoints include:

• /checkpoints-preview
• /checkpoints-restore
• /git-commit

Per-message rollback

Checkpoint handling supports rollback at the message/workspace level so a recent state can be restored when needed.

Related links

• Worktrees