@worldofz/cli-connect

Control your Mac, Windows, or Linux terminal from your iPhone or Android phone.

This npm package ships the cross-platform Go agent (cli-connect) as a single tarball with native binaries for darwin-arm64, darwin-x64, linux-x64, linux-arm64, and win32-x64. A Node shim picks the right one for your platform.

Install

npm install -g @worldofz/cli-connect

Homebrew is also supported:

brew install errr0rr404/tap/cli-connect

First-time pair

cli-connect login

The CLI prints an 8-character code. Open the cli-connect iPhone or Android app (signed in), tap Add Machine, and enter the code.

Run

cli-connect serve       # accept connections from the paired phone
cli-connect attach      # control another paired machine from this terminal
cli-connect status      # show login + serving state
cli-connect logout      # forget this machine

serve runs in the foreground. To run on login:

• macOS → scripts/install-launchd-mac.sh (installs a per-user LaunchAgent)
• Windows → scripts/install-task-scheduler-windows.ps1 (Scheduled Task)
• Linux → ship under your favourite supervisor (systemd --user, runit, …)

How it works

The agent opens a persistent WebSocket to the cli-connect backend. When your phone (or another paired machine) wants a session, the backend forwards bytes between the two sides — no inbound port on this machine, no NAT punching, no Tailscale needed.

serve also listens on the LAN (ws://0.0.0.0:8910), so the phone can connect directly when on the same Wi-Fi or tailnet — pick Auto / Direct / Relay on the app's Connect screen. Use --port N to change the listen port.

Full docs

Complete documentation — including iOS/Android app setup, backend deployment, tmux session picker, attach mode, security model — lives in the project README:

→ github.com/Errr0rr404/cli-connect

Issues and source: same link.

License

MIT.