> ## Documentation Index > Fetch the complete documentation index at: https://docs.partio.io/llms.txt > Use this file to discover all available pages before exploring further. # Commands > Complete reference for all partio CLI commands # CLI Commands ## Global flags | Flag | Type | Default | Description | | ------------- | ------ | ----------- | ----------------------------------------------------- | | `--log-level` | string | From config | Override log level (`debug`, `info`, `warn`, `error`) | *** ## `partio enable` Enable partio in the current Git repository. ```bash theme={null} partio enable [--absolute-path] ``` | Flag | Type | Default | Description | | ----------------- | ---- | ------- | ---------------------------------------------------------- | | `--absolute-path` | bool | `false` | Install hooks using the absolute path to the partio binary | **What it does:** 1. Verifies you're inside a Git repository 2. Creates the `.partio/` config directory 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 **`--absolute-path`:** By default, hooks invoke `partio` by name and rely on PATH resolution at hook execution time. Use `--absolute-path` if partio is not on PATH in your hook execution environment — for example, when using nix, asdf, mise, or system-level git hooks. ```bash theme={null} partio enable --absolute-path ``` This embeds the resolved absolute path of the partio binary into the installed hook scripts. **Output:** ``` partio enabled successfully! - Created .partio/ config directory - Installed git hooks (pre-commit, post-commit, pre-push) - Ready to capture AI sessions on commit ``` If already enabled: ``` partio is already enabled in this repository. ``` *** ## `partio disable` Disable partio in the current repository. ```bash theme={null} partio disable [--remove-data] ``` | Flag | Type | Default | Description | | --------------- | ---- | ------- | --------------------------------------------------- | | `--remove-data` | bool | `false` | Also delete the `.partio/` directory and all config | **What it does:** 1. Removes partio-managed hooks from `.git/hooks/` 2. Restores any backed-up original hooks 3. If `--remove-data`: deletes `.partio/` directory **Output (default):** ``` partio disabled. - Removed git hooks (originals restored from backup if present) - Checkpoint data and config preserved (use --remove-data to delete) ``` *** ## `partio status` Show partio status for the current repository. ```bash theme={null} partio status ``` **Output (enabled):** ``` Repository: /path/to/your-project Branch: main Status: enabled Strategy: manual-commit Agent: claude-code Hooks: installed Checkpoints: branch exists ``` **Output (not enabled):** ``` Repository: /path/to/your-project Branch: main Status: not enabled (run 'partio enable' to set up) ``` *** ## `partio rewind` List or restore checkpoints. ```bash theme={null} partio rewind --list partio rewind --to ``` | Flag | Type | Default | Description | | -------- | ------ | ------- | ------------------------------------------------------- | | `--list` | bool | `false` | List all stored checkpoints | | `--to` | string | `""` | Restore to a specific checkpoint ID (12 hex characters) | **`--list` output:** ``` Checkpoints: a3f8c2d14e9b branch=main agent=87% created=2026-02-17T14:30:00Z bb12340092ac branch=feature/auth agent=100% created=2026-02-16T09:15:22Z ``` **`--to` output:** ``` Rewinding to checkpoint a3f8c2d14e9b Commit: 4f9a2c... Branch: main Context: Created branch: partio/rewind/a3f8c2d14e9b ``` This creates a new branch named `partio/rewind/` checked out at the checkpoint's commit. *** ## `partio resume` Resume a session from a checkpoint. Reads checkpoint data from the orphan branch and launches a new Claude Code session with the previous context. ```bash theme={null} partio resume ``` | Flag | Type | Default | Description | | ---------- | ---- | ------- | ----------------------------------------------------------- | | `--print` | bool | `false` | Print the composed context prompt to stdout | | `--copy` | bool | `false` | Copy the context prompt to clipboard | | `--branch` | bool | `false` | Create a branch at the checkpoint's commit before launching | **Default behavior:** Writes a context file to a temporary directory and launches Claude Code with instructions to read it and continue the previous work. If Claude Code is not found in PATH, the context is printed to stdout instead. **With `--branch`:** Creates a new branch named `partio/resume/` checked out at the checkpoint's commit before launching. ``` Created branch: partio/resume/a3f8c2d14e9b Context written to /tmp/partio-resume-a3f8c2d14e9b.md Launching Claude Code... ``` **With `--print`:** ```bash theme={null} partio resume a3f8c2d14e9b --print ``` Prints the composed context prompt (including the original request, plan, diff, and session metadata) to stdout without launching Claude Code. **With `--copy`:** Copies the context prompt to the system clipboard (macOS and Linux). *** ## `partio doctor` Check partio installation health. ```bash theme={null} partio doctor ``` **Checks performed:** 1. `.partio/` directory exists 2. `pre-commit` hook installed and managed by partio 3. `post-commit` hook installed and managed by partio 4. `pre-push` hook installed and managed by partio 5. `partio/checkpoints/v1` branch exists 6. partio binary found in PATH **Output (healthy):** ``` [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! ``` **Output (issues found):** ``` [WARN] .partio/ directory missing - run 'partio enable' [WARN] pre-commit hook missing [OK] post-commit hook installed [WARN] post-commit hook exists but not managed by partio [WARN] checkpoint branch missing [OK] partio binary found (you're running it!) 4 issue(s) found. Run 'partio enable' to fix. ``` *** ## `partio reset` Reset the checkpoint branch. This deletes all stored checkpoint data and recreates the branch. ```bash theme={null} partio reset ``` **Output:** ``` Checkpoint branch reset successfully. ``` This permanently deletes all checkpoint data. This cannot be undone. *** ## `partio clean` Remove orphaned checkpoint data. ```bash theme={null} partio clean ``` Scans the checkpoint branch for data that no longer corresponds to any commit. **Output:** ``` Checkpoint data present on partio/checkpoints/v1 branch. To fully reset, run: partio reset ``` *** ## `partio version` Print the partio version. ```bash theme={null} partio version ``` **Output:** ``` partio v0.1.0 ```