Skip to main content

​
Quick Start

​
Install

brew install partio-io/tap/partio
Verify the installation: 
partio version
# partio v0.1.0

​
Enable in a repository

Navigate to any Git repository and enable partio: 
cd your-project
partio enable
You’ll see: 
partio enabled successfully!
  - Created .partio/ config directory
  - Installed git hooks (pre-commit, post-commit, pre-push)
  - Ready to capture AI sessions on commit
That’s it. No config files to write, no environment variables to set.

​
Your first checkpoint

  1. Start an AI coding session (e.g., open Claude Code)
  2. Make some changes to your code
  3. Commit as you normally would:
git commit -m "Add user authentication"
partio automatically:
  • Detects the running AI agent
  • Captures the session transcript, prompts, and context
  • Stores everything on the partio/checkpoints/v1 branch
  • Appends attribution trailers to your commit message
Your commit message will include: 
Add user authentication

Partio-Checkpoint: a3f8c2d14e9b
Partio-Attribution: 87% agent

​
Explore checkpoints

List all captured checkpoints: 
partio rewind --list

Checkpoints:

  a3f8c2d14e9b  branch=main  agent=87%  created=2026-02-17T14:30:00Z
Rewind to explore a specific checkpoint: 
partio rewind --to a3f8c2d14e9b
This creates a new branch at that checkpoint so you can explore the code and AI session in context.

​
Verify everything is healthy

partio doctor

[OK]   .partio/ directory exists
[OK]   pre-commit hook installed
[OK]   post-commit hook installed
[OK]   pre-push hook installed
[OK]   checkpoint branch exists
[OK]   partio binary found (you're running it!)

All checks passed!

​
Next steps