Skip to main content

Checkpoints and Sessions

Bitloops captures work as sessions and checkpoints, then stores the durable record in daemon-managed backends.

Sessions​

A session represents an agent-assisted working run in a repository or worktree.

Checkpoints​

A checkpoint is a persisted summary of a meaningful step in that session, usually tied to the configured capture strategy such as manual-commit.

Where State Lives Now​

Under the current architecture:

  • durable session and checkpoint data live in the configured stores
  • daemon runtime metadata lives in the platform state directory
  • repo-local runtime directories are no longer the default source of truth

Repo Policy​

Capture behaviour comes from repo policy:

[capture]
enabled = true
strategy = "manual-commit"

Use:

bitloops checkpoints status
bitloops checkpoints status --detailed

The detailed view shows the resolved policy root and config fingerprint.