Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 11 additions & 1 deletion cli/commands.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ partio enable [--absolute-path]
3. Writes default `settings.json`
4. Adds `.partio/settings.local.json` to `.gitignore`
5. Installs Git hooks (`pre-commit`, `post-commit`, `pre-push`)
6. Creates the `partio/checkpoints/v1` orphan branch
6. Creates the `partio/checkpoints/v1` branch — if a remote tracking branch already exists (e.g., on a fresh clone), the local branch is created from the remote to preserve existing checkpoint history; otherwise a new orphan branch is created

**`--absolute-path`:**

Expand All @@ -53,6 +53,16 @@ partio enabled successfully!
- Ready to capture AI sessions on commit
```

On a fresh clone where checkpoint history already exists on the remote:

```
partio enabled successfully!
- Created .partio/ config directory
- Installed git hooks (pre-commit, post-commit, pre-push)
- Restored checkpoint history from remote branch
- Ready to capture AI sessions on commit
```

If already enabled:

```
Expand Down
10 changes: 10 additions & 0 deletions quickstart.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -55,6 +55,16 @@ partio enabled successfully!

That's it. No config files to write, no environment variables to set.

If you cloned a repository where partio was already in use, the remote checkpoint branch is detected automatically and your local branch is set up to track it — no manual `git fetch` required:

```
partio enabled successfully!
- Created .partio/ config directory
- Installed git hooks (pre-commit, post-commit, pre-push)
- Restored checkpoint history from remote branch
- Ready to capture AI sessions on commit
```

## Your first checkpoint

1. Start an AI coding session (e.g., open Claude Code)
Expand Down