@arnavpadwal/pi-backup

Backup and restore your entire pi configuration — shareable zip, excludes API keys

Packages

Package details

extension

Install @arnavpadwal/pi-backup from npm and Pi will load the resources declared by the package manifest.

npm report

$ pi install npm:@arnavpadwal/pi-backup

Package: @arnavpadwal/pi-backup
Version: 1.0.0
Published: May 12, 2026
Downloads: 36/mo · 12/wk
Author: arnavpadwal
License: MIT
Types: extension
Size: 16.5 KB
Dependencies: 0 dependencies · 0 peers

Pi manifest JSON

{
  "extensions": [
    "./extensions/pi-backup.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@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