pi-share

Share sanitized Pi coding agent configuration with a Pi extension and a small Cloudflare backend.

Install

pi install npm:pi-share

Then run /reload if Pi is already open.

What it shares

By default pi-share exports shareable files from ~/.pi/agent:

• settings.json
• keybindings.json
• AGENTS.md, SYSTEM.md, APPEND_SYSTEM.md
• extensions/
• skills/
• prompts/
• themes/

It excludes auth, sessions, trust decisions, backups, .env, and secret-looking files/content.

Pi commands

/share-export --name my-config
/share-export --name my-config --password abcdef
/share-preview <id> [--password abcdef]
/share-import <id> [--password abcdef]
/share-delete <id:deleteToken>

Plain export is unencrypted for easiest sharing. Password export encrypts locally with scrypt + AES-256-GCM; the backend only stores ciphertext.

Use a custom backend during development:

/share-export --api http://localhost:8787
/share-import <id> --api http://localhost:8787

or set:

export PI_SHARE_API_URL=http://localhost:8787

Cloudflare backend

Stack:

• Worker: API
• R2: profile blobs
• D1: share metadata

Endpoints:

POST   /v1/shares
GET    /v1/shares/:id
DELETE /v1/shares/:id

Setup

bun install
wrangler r2 bucket create pi-share
wrangler d1 create pi-share

Copy the example config and put the created D1 database id into wrangler.toml:

cp wrangler.example.toml wrangler.toml

Then:

bun run db:migrate
bun run worker:deploy

For local development:

bun run db:migrate:local
bun run worker:dev

Development

bun install
bun test
bun run typecheck

Install locally into Pi from this repo:

pi install /absolute/path/to/pi-share

Then /reload if Pi is already open.