Quick Start

Install

Homebrew
Go Install
From Source

brew install partio-io/tap/partio

go install github.com/partio-io/cli/cmd/partio@latest

git clone https://github.com/partio-io/cli.git
cd cli
go build -o partio ./cmd/partio
sudo mv partio /usr/local/bin/

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!
  - Ensured .partio/ config directory exists
  - 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

Start an AI coding session (e.g., open Claude Code)
Make some changes to your code
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

Learn about Core Concepts — sessions, checkpoints, and strategies
See the full CLI Reference
Set up the Claude Code integration

Getting Started

CLI Reference

App

Extension

Integrations

Quick Start

Quick Start

Install

Enable in a repository

Your first checkpoint

Explore checkpoints

Verify everything is healthy

Next steps

​Quick Start

​Install

​Enable in a repository

​Your first checkpoint

​Explore checkpoints

​Verify everything is healthy

​Next steps

Quick Start

Install

Enable in a repository

Your first checkpoint

Explore checkpoints

Verify everything is healthy

Next steps