Metadata-Version: 2.4
Name: autocheckpoint
Version: 0.1.4
Summary: Never lose your code or your project context again. AI Development Continuity tool.
Home-page: https://github.com/epicadidash/talvo-demo
Author: AutoCheckpoint Maintainers
Author-email: maintainers@autocheckpoint.dev
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: watchfiles>=0.21.0
Requires-Dist: typer>=0.9.0
Requires-Dist: rich>=13.7.0
Requires-Dist: pyyaml>=6.0.1
Requires-Dist: pathspec>=0.12.1
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# 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.

```text
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`
```bash
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`
```bash
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:
```bash
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

```bash
pip install -e .
```

---

## 4. Quick Start

```bash
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:
```ignore
.git/
node_modules/
venv/
__pycache__/
```
*(Note: `.autocheckpoint/context.yaml` is always captured in snapshots even if `.autocheckpoint/` is ignored.)*
