@pi-unipi/app-bridge

Live bridge between a pi TUI session and the UniPi phone app — streaming chat, prompts, steering and dialogs from the phone

Packages

Package details

extension

Install @pi-unipi/app-bridge from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@pi-unipi/app-bridge
Package
@pi-unipi/app-bridge
Version
3.0.0-alpha.31
Published
Oct 7, 2026
Downloads
1,533/mo · 1,533/wk
Author
neuron-mr-white
License
MIT
Types
extension
Size
39 KB
Dependencies
1 dependency · 1 peer
Pi manifest JSON
{
  "skills": [],
  "themes": [],
  "prompts": [],
  "extensions": [
    "./index.ts"
  ]
}

Security note

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

README

@pi-unipi/app-bridge

Lets the UniPi phone app mirror a pi session that runs in a herdr pane, live, and talk to it: what you type on the phone shows in the TUI as a normal message, and everything pi streams in the TUI streams on the phone.

  • TUI mode only. Each pi listens on ~/.unipi/bridge/<pid>.sock (owner-only) and writes ~/.unipi/bridge/<pid>.json (session file, cwd, herdr pane), so unipi-host can find the pi behind a herdr pane.
  • Sending while pi works steers it (like Enter in the TUI); the app can also queue a follow-up.
  • Dialogs (ctx.ui.select / confirm / input / editor) and ask_user can be answered from the phone; the first answer wins and the other side closes.
  • /model, /thinking and /compact are mapped to bridge calls.
  • Off switch: UNIPI_APP_BRIDGE=0. Subagent children never open a bridge.

Protocol: unipi-app/docs/m5/PROTOCOL.md.