@arnavpadwal/pi-backup

Backup and restore your full pi configuration — themes, extensions, skills, models, settings, keybindings, sessions, and memory — into a single portable zip file.

Privacy-first: API keys and OAuth tokens (auth.json) are never included. apiKey fields in models.json are automatically stripped.

Perfect for migrating to a new machine, sharing your setup, or snapshotting before risky experiments.

Installation

pi install npm:@arnavpadwal/pi-backup
# or from source:
pi install /path/to/pi-backup

Or just copy extensions/pi-backup.ts to ~/.pi/agent/extensions/.

Usage

| Command | Description | |---------|-------------| | /pi-backup backup [name] | Create a backup zip at ~/pi-backups/<name>.zip | | /pi-backup restore <path> | Restore from a backup zip |

Backup

/pi-backup backup

Creates ~/pi-backups/pi_backup_2026-05-12_142530.zip containing everything except auth keys.

Restore

/pi-backup restore ~/pi-backups/pi_backup_2026-05-12_142530.zip

Extracts and restores everything to ~/.pi/agent/. Run /reload after.

What's included

| Item | Included | Privacy | |------|----------|---------| | settings.json | ✅ (scoped model selections too) | Safe | | models.json | ✅ apiKey/authHeader fields stripped | Stripped | | extensions/ | ✅ Source .ts files only | Safe | | skills/ | ✅ | Safe | | themes/ | ✅ | Safe | | keybindings.json | ✅ | Safe | | sessions/ | ✅ All projects | Safe | | memory.db | ✅ | Preferences only | | auth.json | ❌ Excluded entirely | API keys | | node_modules/ | ❌ Reinstalled via pi install | — |

Requirements

• zip and unzip CLI tools (pre-installed on macOS/Linux)
• pi v0.74.0+

Publishing

cd pi-backup
npm publish --access public
# or push to GitHub:
pi install git:github.com/arnavpadwal/pi-backup