{"id":50232896,"url":"https://github.com/mike-heunher/pipane","last_synced_at":"2026-08-09T11:30:15.422Z","repository":{"id":341529714,"uuid":"1170148225","full_name":"mike-heunher/pipane","owner":"mike-heunher","description":"PIpane, a web UI for the PI agent","archived":false,"fork":false,"pushed_at":"2026-08-09T06:59:48.000Z","size":32113,"stargazers_count":37,"open_issues_count":2,"forks_count":4,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-08-09T11:13:54.046Z","etag":null,"topics":["pi","pi-mono"],"latest_commit_sha":null,"homepage":"https://github.com/mike-heunher/pipane","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mike-heunher.png","metadata":{"files":{"readme":"README.md","changelog":"changelog.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","claude":null,"gemini":null,"cursor":null,"copilot":null,"dco":null,"cla":null,"disclosure":null}},"created_at":"2026-03-01T19:14:42.000Z","updated_at":"2026-08-09T06:59:58.000Z","dependencies_parsed_at":"2026-08-09T08:20:34.414Z","dependency_job_id":null,"html_url":"https://github.com/mike-heunher/pipane","commit_stats":null,"previous_names":["mike-heunher/pipane"],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/mike-heunher/pipane","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mike-heunher%2Fpipane","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mike-heunher%2Fpipane/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mike-heunher%2Fpipane/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mike-heunher%2Fpipane/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mike-heunher","download_url":"https://codeload.github.com/mike-heunher/pipane/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mike-heunher%2Fpipane/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":36451347,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-08-06T04:43:03.162Z","status":"online","status_checked_at":"2026-08-09T02:00:06.528Z","response_time":130,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["pi","pi-mono"],"created_at":"2026-05-26T19:00:32.254Z","updated_at":"2026-08-09T11:30:15.406Z","avatar_url":"https://github.com/mike-heunher.png","language":"TypeScript","funding_links":[],"categories":["Extensions"],"sub_categories":[],"readme":"# pipane\n\nA clean web interface for the **pi coding agent**. Open any pi conversation in pipane, open any pipane conversation in pi -- full interop.\n\n`pipane` runs a local backend that launches `pi` in RPC mode and streams agent messages to a browser UI over WebSocket.\n\n## Walkthrough\n\nHero shot:\n\n![pipane walkthrough hero](e2e/screenshots/walkthrough-hero.png)\n\nWalkthrough (GIF):\n\n![pipane walkthrough](e2e/videos/walkthrough.gif)\n\n---\n\n## Quickstarts\n\nRequires Node.js 22.19 or newer, matching the bundled Pi runtime and extension APIs.\n\n```bash\nnpm install -g pipane\n```\n\nIf `pi` is missing, install it like this:\n\n```bash\nnpm install -g @earendil-works/pi-coding-agent\n```\n\nRun `pipane` to start the backend. It registers with `https://pipane.dev` by default and uses the machine's short hostname as its backend name, so no remote-access environment variables are required. Set `PIPANE_BACKEND_NAME` to customize the name, `PIPANE_RENDEZVOUS_URL` to use another rendezvous service, or set `PIPANE_RENDEZVOUS_URL` to an empty value to disable remote registration.\n\nAuthorize the first browser by running `pipane pair` and opening its short-lived link or scanning its QR code. From an authorized pipane.dev workspace, use the workspace-wide **Add device** button beside **Pipane settings** to create a one-use, ten-minute QR code and link. The new browser receives access to the same account backends without transferring the original browser's private key.\n\nIf rendezvous can reach an online backend but WebRTC cannot find a direct ICE path, Pipane offers browser-local **TURN relay settings** from the recovery screen, connection diagnostics, pairing page, and host menu. The guided setup supports [Metered Open Relay](https://www.metered.ca/tools/openrelay/), a publicly reachable self-hosted coturn server using REST shared-secret credentials, or standard static `iceServers` JSON from another provider. Long-term Metered keys and coturn shared secrets remain in that browser; Pipane forwards only temporary TURN credentials for each connection. TURN relays encrypted WebRTC traffic but can still observe endpoint IP addresses, timing, and traffic volume.\n\n### Explicit local deployments\n\nDeploy the current working tree to the separate dev instance with:\n\n```bash\nnpm run deploy:dev\n```\n\nThis builds a release, atomically advances the `pipane-dev` systemd service, and verifies it on port `8223`. It does not change production.\n\nTo try the same working-tree change through the public site without publishing npm, deploy a preview stack:\n\n```bash\nnpm run deploy:preview\n```\n\nThis starts a detached `pipane-preview-deploy` systemd unit and deploys a matching, isolated stack: the local `pipane-dev` backend plus the rendezvous server and browser at `https://preview.pipane.dev`. Detaching lets the workflow survive the local backend restart; follow it with `journalctl -u pipane-preview-deploy -f`. The remote runtime is installed from the working-tree build without publishing or globally installing npm, uses separate rendezvous trust state, and rolls back atomically if its service, health endpoint, or browser checksum fails. Production `pipane.dev` and the local production backend remain untouched. Override the deployment target with `PIPANE_PREVIEW_RENDEZVOUS_HOST`, `PIPANE_PREVIEW_RENDEZVOUS_ROOT`, or `PIPANE_PREVIEW_PUBLIC_URL` when needed.\n\nDeploy the current committed working tree to local production with:\n\n```bash\nnpm run deploy:prod\n```\n\nProduction deployment requires a clean Git working tree, atomically advances the `pipane` systemd service, verifies it on port `8222`, and rolls back if the health check fails. Both commands skip dependency installation when `package-lock.json` is unchanged and retain five releases.\n\n```bash\njournalctl -u pipane-dev -f\njournalctl -u pipane -f\n```\n\n---\n\n## What you get\n\n- Session list and clean UI for `pi`\n- Real-time tool calls and streaming output, nicely crafted\n- One recency-sorted cross-host project picker on pipane.dev\n- ChatGPT/Codex and Claude subscription usage in the input toolbar\n- A large amount high quality \"vibe-code\".\n\nProvider usage is supplied by the bundled `@sreetej510/pi-usage` Pi extension and uses Pi's existing authentication. Set `PIPANE_USAGE_EXTENSION=0` when starting pipane to disable it.\n\n---\n\n## Browser UI ownership\n\nThe renderer tree under [`src/client/ui/`](src/client/ui/) is maintained directly by pipane. It is derived from the final pi-mono `web-ui` release (`v0.75.3`) with pipane's flat message renderer, steering editor, thinking display, attachment handling, and tool renderers integrated into one local path. Pipane does not patch or load an external `pi-web-ui` package. See [`UPSTREAM.md`](src/client/ui/UPSTREAM.md) and [`THIRD_PARTY_NOTICES.md`](THIRD_PARTY_NOTICES.md).\n\nThe versioned browser WebSocket contract and validated Pi subprocess boundary are documented in [`docs/protocol.md`](docs/protocol.md).\n\n## Testing\n\nRun the complete local verification gate with:\n\n```bash\nnpm run test:all\n```\n\nThis typechecks the repository, runs Vitest with coverage thresholds, builds the production client/server, and runs the deterministic Playwright suite. The real-credential walkthrough is separate: `npm run test:walkthrough`.\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmike-heunher%2Fpipane","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmike-heunher%2Fpipane","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmike-heunher%2Fpipane/lists"}