Licence
MIT
Version
1.0.4
Deps
3
Size
48 kB
Vulns
0
Weekly
0
helixbox-connect
Run this on your computer, pair your phone by scanning a QR code, and code remotely from anywhere — files, terminal, git, AI, and a live browser preview of your local web apps, all over one WebSocket.
It's the agent half of Helixbox: it runs on the machine you want to control and connects to the hosted relay; the Helixbox mobile app is the client.
Requirements
- Node.js 18 or newer
- The Helixbox mobile app (to scan the QR / enter the code)
Usage
npx helixbox-connectIt prints a QR code and a short session code, then waits. Open the Helixbox app → Scan QR code → point it at your terminal → you're paired. Works from any network (the app and this agent meet at the hosted relay).
Options (environment variables)
| Variable | Default | Purpose |
|---|---|---|
HELIXBOX_GATEWAY |
https://helixbox-relay.onrender.com |
Relay URL (use a self-hosted relay here) |
HELIXBOX_ROOT |
current directory | Starting folder shown as "Workspace" |
# point at your own relay, start in a specific project
HELIXBOX_GATEWAY=https://my-relay.example.com HELIXBOX_ROOT=~/dev/myapp npx helixbox-connectWhat the app can do once paired
- Files — browse and edit anywhere on the machine
- Terminal — a real shell on your computer
- Git — status, diff, stage, commit, push/pull (uses your machine's credentials)
- AI — drives an AI CLI installed on the machine (Codex / Claude / opencode)
- Preview — open a local dev server (e.g.
npm run dev) in the app's browser
Notes
- Commands run on your machine, not the phone.
- AI uses whatever AI CLI is installed & authenticated locally; no keys leave your machine.
- Source & the mobile app: https://github.com/bannu773/helixbox-flutter
MIT