pi-web-sync

Sync your pi coding sessions to a live web app in real time.

Install

pi install npm:pi-web-sync

Configuration

Option 1: Config file (recommended)

Create a JSON file at one of these locations:

| Location | Scope | Path | |---|---|---| | Global (all projects) | User-wide | ~/.pi-web-sync.json | | Project (per-project) | Local override | .pi-web-sync.json |

Required fields:

{
  "relayUrl": "ws://localhost:8787",
  "webappUrl": "http://localhost:5173"
}

| Field | Description | |---|---| | relayUrl | WebSocket relay URL (required) | | webappUrl | Web app base URL for session links (required) |

Set once, works for every pi session.

Option 2: Environment variables

export PI_WEB_SYNC_RELAY_URL=ws://localhost:8787
export PI_WEB_SYNC_WEBAPP_URL=http://localhost:5173

Option 3: Interactive command

In pi, use the /web-sync command:

/web-sync connect ws://localhost:8787 http://localhost:5173

You must provide your own relay and web app. See the main repository for self-hosting instructions.

How it works

• Each pi session generates a unique session ID
• The extension streams your conversation to a WebSocket relay
• Open the session URL in any browser to mirror your chat
• Type in the browser and it reaches pi

License

MIT