git404hub

what is pi-share fr?

awesamarth/pi-share — explained in plain English

Analysis updated 2026-05-18

0TypeScriptAudience · developerComplexity · 2/5Setup · moderate

tl;dr

pi-share is a Pi coding agent extension that exports your sanitized Pi configuration for sharing, backed by a small Cloudflare Worker, R2, and D1 service.

vibe map

mindmap
  root((pi-share))
    What it does
      Export Pi config
      Optional encryption
      Import shared config
    Tech stack
      TypeScript
      Cloudflare Workers
      R2 and D1
    Use cases
      Share settings with teammates
      Self-host backend
    Audience
      Pi agent users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Share your Pi settings, keybindings, skills, and prompts with a teammate.

VIBE 2

Import someone else's shared Pi configuration by ID, with an optional password.

VIBE 3

Deploy your own Cloudflare-backed pi-share instance for local development or a team.

what's the stack?

TypeScriptCloudflare WorkersR2D1Bun

how it stacks up fr

awesamarth/pi-share0xkinno/astraea0xkinno/halcyon
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardhard
Complexity2/54/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Self-hosting the backend needs Bun, Wrangler, a Cloudflare R2 bucket, and a D1 database.

in plain english

pi-share is an extension for the Pi coding agent that lets you export your personal Pi configuration so it can be shared with someone else, along with a small backend service that stores and serves those shared configurations. By default, it packages up files such as your settings, keyboard shortcuts, agent instruction files, extensions, skills, prompts, and themes from your local Pi configuration folder, while leaving out anything related to authentication, session history, trust decisions, backup files, and anything that looks like a secret or an environment file. Once installed as a Pi extension, it adds a set of chat style commands: exporting your configuration under a chosen name, optionally with a password, previewing or importing someone else's shared configuration by its ID, and deleting a share using a delete token you received when you created it. An export made without a password is stored as plain, readable data for the easiest sharing experience, while a password protected export is encrypted on your own machine first, using scrypt and AES-256-GCM, so the backend server only ever stores scrambled data it cannot read. The backend that stores and serves shares is built as a Cloudflare Worker, using Cloudflare R2 for the actual configuration files and Cloudflare D1, a small SQL database, for the metadata about each share. It exposes a simple API for creating, fetching, and deleting a share. Setting it up requires the Bun JavaScript runtime and the Wrangler command line tool, creating an R2 bucket and a D1 database, copying an example configuration file and filling in the new database ID, then running a database migration and deploying the worker. There is also a local development mode that runs the same backend on your own machine for testing before deploying it for real. The project can also be installed directly from a local folder rather than from the npm registry, which is useful while working on it.

prompts (copy fr)

prompt 1
Help me install pi-share into Pi and run the share-export command.
prompt 2
Walk me through deploying pi-share's Cloudflare Worker, R2 bucket, and D1 database.
prompt 3
Explain how pi-share's password-protected export encryption works.

Frequently asked questions

what is pi-share fr?

pi-share is a Pi coding agent extension that exports your sanitized Pi configuration for sharing, backed by a small Cloudflare Worker, R2, and D1 service.

What language is pi-share written in?

Mainly TypeScript. The stack also includes TypeScript, Cloudflare Workers, R2.

How hard is pi-share to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is pi-share for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.