@huntye1/pi-mobile

One-command installer and service CLI for the Pi Mobile PWA

Packages

Package details

extension

Install @huntye1/pi-mobile from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@huntye1/pi-mobile

Package: @huntye1/pi-mobile
Version: 0.1.2
Published: Oct 19, 2026
Downloads: 389/mo · 389/wk
Author: huntye1
License: MIT
Types: extension
Size: 1.4 MB
Dependencies: 6 dependencies · 0 peers

Pi manifest JSON

{
  "extensions": [
    "./runtime/bridge/mobile-bridge.js"
  ]
}

Security note

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

README

@huntye1/pi-mobile

简体中文

Experimental all-in-one Pi Mobile CLI for macOS/Linux. Includes Web, Gateway, TUI Bridge, managed launcher and authenticated local supervisor.

Install

Requires Node.js >=22.19.0 <23 and Pi installed separately:

npm install --global @huntye1/pi-mobile
pi-mobile setup
pi-mobile doctor

Setup installs the bundled Pi Mobile Bridge through a stable personal Pi package and starts Gateway. Existing Pi TUI loads it only when you choose /reload; new Pi processes load it automatically. Setup does not configure trust/model authentication. Controlled new-session creation additionally requires tmux.

For source development, build apps/pi-mobile-cli/publish in the repository and install that reviewed folder/tarball instead.

Lifecycle and safety

Commands: setup/start/stop/restart/status/doctor/logs/config/update/rollback/uninstall. Default loopback; LAN requires TLS, exact hosts and explicit acknowledgement. No application login or OS startup. Windows live/supervisor support is unimplemented.

CLI installer and selected runtime are separate: installing a CLI does not update a running Gateway; update --source changes its runtime, not the installer or already-loaded Pi Bridge. Logs/recovery are bounded, and PID files alone never grant stop authority.

Source is MIT; included THIRD_PARTY_NOTICES.txt inventories third-party licenses. No application credentials or source maps are included.

See installation and operations. Source documentation requires repository access while private.