autocheckpoint 0.2.1

Never lose your code or your project context again. AI Development Continuity tool.

AutoCheckpoint

Never lose your code or your project context again.

AutoCheckpoint delivers AI Development Continuity for developers. It bridges the gap between VM losses and AI agent memory resets.

Claude Session #1
      ↓
AutoCheckpoint
      ↓
Claude Session #2
      ↓
Cursor
      ↓
VS Code

The Continuity Formula

Code Recovery + Context Recovery + AI Session Handoff

Unlike basic backup tools, AutoCheckpoint preserves both your code and your project's portable brain (decisions, intent, constraints, and current tasks). When your cloud VM dies, you restore your workspace and instantly hand off the context to the next AI session.

---

1. Hero Feature: AI Session Handoff

Every AI developer knows this pain:

New Claude/Gemini session...
"Okay... what were we doing again?"

With AutoCheckpoint, you never start from zero.

handoff

autocheckpoint handoff

Generates a clean project state summary containing your Goal, Current Focus, Decisions, Constraints, and Tasks. It saves this as a .autocheckpoint/handoff.md file (which is bundled automatically into your snapshots).

handoff --markdown

autocheckpoint handoff --markdown

Or use the shortcut -m to output the raw markdown directly to your terminal. Copy and paste it instantly into Claude Code, Cursor, Gemini, ChatGPT, or VS Code agents so your AI is instantly up to speed.

---

2. Recovery After a VM Loss

When a cloud VM disappears, you don't just lose files; you lose momentum.

AutoCheckpoint lets you:

Restore your code, project context, decisions, tasks, and session handoff after a VM loss.

(Note: AutoCheckpoint restores your codebase, decisions, and handoff files, but not running processes, docker containers, or browser tabs.)

restore

Run this command on your fresh VM:

autocheckpoint restore

It will:

1. Prompt for your backup location (e.g. Google Drive, OneDrive, network mount).
2. Scan your backup directory and list your projects.
3. Restore files and the complete context.yaml state.
4. Auto-detect the saved handoff so you can immediately resume coding.

---

3. Installation

pip install -e .

---

4. Quick Start

autocheckpoint init

1. Asks where to store backups (outside the project directory).
2. Automatically starts the background watcher.
3. Scans your project to automatically detect context (README, git history, codebase) and initializes your project's context.

From then on, a snapshot is created automatically whenever you save file changes.

---

5. CLI Command Reference

Watcher Controls

• autocheckpoint start — Start the watcher in the foreground.
• autocheckpoint start --background — Run the watcher as a background daemon.
• autocheckpoint stop — Stop the background watcher.
• autocheckpoint status — Check the watcher's current state, snapshot count, and active context.

Context Management

AutoCheckpoint maintains .autocheckpoint/context.yaml as the portable project brain.

• autocheckpoint context show — View the current context summary.
• autocheckpoint context refresh — Scan the codebase and git history with AI to auto-update context.
• autocheckpoint context set-intent "<goal>" — Define the main goal of the project.
• autocheckpoint context set-focus "<focus>" — Update your current active task.
• autocheckpoint context add-decision "<decision>" — Record an architectural/design decision.
• autocheckpoint context add-constraint "<constraint>" — Record environment or workspace limitations.
• autocheckpoint context add-task "<task>" — Add a task to the todo list.
• autocheckpoint context done-task — Interactively select and mark a task as completed.
• autocheckpoint context add-session "<summary>" — Summarize the current session.
• autocheckpoint context summarize — Run the interactive wizard to update all context fields at once.

---

Ignore Patterns

Create a .autocheckpointignore file in your project root to exclude directories:

.git/
node_modules/
venv/
__pycache__/

(Note: .autocheckpoint/context.yaml is always captured in snapshots even if .autocheckpoint/ is ignored.)