pi-remote-control

Authenticated remote control for Pi sessions.

Packages

Package details

extension

Install pi-remote-control from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:pi-remote-control

Package: pi-remote-control
Version: 1.0.3
Published: May 26, 2026
Downloads: 455/mo · 37/wk
Author: zerray
License: MIT
Types: extension
Size: 337.4 KB
Dependencies: 5 dependencies · 2 peers

Pi manifest JSON

{
  "extensions": [
    "./src/extension/index.ts"
  ]
}

Security note

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

README

Pi Remote Control

Private relay daemon for iOS remote control of explicitly enabled Pi TUI sessions.

App Store: https://apps.apple.com/us/app/pi-relay/id6768893799

Run

Install as a Pi package:

pi install https://github.com/zerray/pi-remote-control

After installation, edit ~/.pi/remote-control/config.json so iOS can reach the daemon. Use a LAN IP or Tailscale address. Exposing the daemon on a public IP is at your own risk.

LAN example:

{
  "bindAddress": "192.168.1.23:17373",
  "advertisedBaseUrl": "http://192.168.1.23:17373"
}

Tailscale example:

{
  "bindAddress": "100.86.12.34:17373",
  "advertisedBaseUrl": "http://100.86.12.34:17373"
}

Then open a Pi TUI session and run:

/remote-control-pair  # display QR code and desktop hex payload for pairing
/remote-control       # toggle this TUI session for remote control

Directory overview

scripts/http-smoke-test.sh — curl/WebSocket smoke test for daemon HTTP endpoints.
docs/architecture.md — daemon architecture, Pi package shape, and lifecycle boundaries.
docs/interfaces.md — daemon public API and TUI control integration contract.
docs/data-model.md — daemon state, pairing, device, active session, and stream structures.
docs/adr/ — accepted daemon decisions.