JSPM

dnp-remote-linux

0.1.0
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 9
  • Score
    100M100P100Q60252F
  • License MIT

Linux daemon + local web UI that pairs with the DNP Remote IDE iPhone companion. Exposes Claude Code (and any PTY-driven shell) over a signed WebSocket bridge so you can drive a Linux box from your phone.

Package Exports

  • dnp-remote-linux
  • dnp-remote-linux/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (dnp-remote-linux) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

DNP Remote · Linux

Linux daemon + local web UI that pairs with the DNP Remote IDE iPhone companion. Drive Claude Code (or any PTY shell) on a Linux box straight from your phone — same signed envelopes the Mac IDE uses, same iPhone app, no extra account required.

npm License Node

Install + run (30 seconds)

# Global install
npm install -g dnp-remote-linux

# Start the daemon — opens the pairing UI in your browser
dnp-remote

That's it. The terminal prints a banner with the bridge endpoint (tcp://<lan-ip>:18733) and the local UI URL (http://localhost:17834). On the iPhone, open the DNP Remote IDE app, tap Scan QR, point at the QR code in the browser — paired.

Heads-up: node-pty builds against your Node ABI on first install, so the box needs python3 + make + a C++ compiler available (already there on every mainstream distro: apt install build-essential, dnf groupinstall "Development Tools", etc.).

What you get

  • ✅ Real PTY sessions — node-pty (forkpty) gives you a true tty. Vim, fzf, htop, and Claude Code's full TUI all render correctly on the iPhone, complete with raw-mode keystrokes routed through the bridge.
  • ✅ Pair from QR — same handshake the Mac uses. Token rotates on every restart; the daemon stores the iPhone's Ed25519 public key in ~/.config/dnp-remote/identity.json so reconnects don't need the QR again.
  • ✅ Signed envelopes — every WebSocket frame carries a 64-byte Ed25519 signature over canonical JSON, plus a 16-byte nonce + ISO timestamp for replay protection. A network attacker on your LAN can't impersonate the iPhone.
  • ✅ Headless friendly — pass --no-open to suppress the browser launch when the box has no display server (servers, SSH sessions). Visit the UI from your laptop on the same LAN, pair from there.
  • ✅ Same iPhone app, multiple targets — once the iPhone is paired with this Linux box, it shows up alongside any Mac you've paired earlier. Switch between hosts from the iPhone's device list.

Common flags

dnp-remote --shell "claude --model claude-opus-4-7"  # default command per session
dnp-remote --cwd /home/me/projects/myapp             # default working directory
dnp-remote --bridge-port 18733 --ui-port 17834       # ports (defaults shown)
dnp-remote --host my-server.tail-something.ts.net    # override LAN host (for Tailscale)
dnp-remote --no-open                                 # don't auto-open browser
dnp-remote --help

The bridge port defaults to 18733 — the same port the Mac IDE listens on — so the iPhone doesn't need any per-host configuration.

How it works

┌────────────────────────────────────────────────┐
│  Linux box                                      │
│                                                 │
│   $ dnp-remote                                  │
│        │  spawns                                │
│        ▼                                        │
│   ┌──────────────────────────────────────┐     │
│   │ Node 20 daemon                       │     │
│   │  • node-pty (claude / bash / ...)    │     │
│   │  • WebSocket bridge (port 18733)     │  ◄──┼─── iPhone over LAN / Tailscale
│   │  • HTTP UI server (localhost:17834)  │     │     (signed envelopes,
│   │  • Ed25519 envelope signing          │     │      length-prefixed JSON)
│   └──────────────────────────────────────┘     │
│        │  serves                                │
│        ▼                                        │
│   http://localhost:17834 → pair QR + status    │
└────────────────────────────────────────────────┘

Wire compatibility: identical to the Mac IDE's bridge protocol — BridgeEnvelope<P> with sorted-keys canonical JSON, length-prefixed frames over WebSocket. The same iPhone build talks to either daemon with no flag, just by which paired device the user picks.

Configuration files

The daemon writes a single file:

~/.config/dnp-remote/identity.json   # chmod 600 — Ed25519 secret + paired peers

Delete that file to revoke every paired iPhone in one shot. The next dnp-remote start will mint a fresh keypair + token and you can re-pair from scratch.

Building from source

git clone https://github.com/rotem221/dnp-remote-linux.git
cd dnp-remote-linux
npm install
npm run build      # tsc → dist/
node bin/dnp-remote.cjs

Watch mode:

npm run watch      # in one terminal
node bin/dnp-remote.cjs   # in another, restart on each rebuild

Roadmap

  • Phase 2 — semantic event extraction: parse Claude Code's TUI output into the same command / codeEdit / toolActivity / approval events the Mac normaliser emits, so the iPhone shows feature-parity cards instead of a plain raw-tty stream.
  • File explorer — directory listings, file content read + write, search. Same bridge messages the Mac speaks (directoryListingRequest, etc.).
  • Permissions UI — fine-grained allow/deny rules persisted under ~/.config/dnp-remote/permissions.json, plus a UI surface in the local dashboard.
  • systemd unit — first-class dnp-remote.service so the daemon launches on boot for headless servers.
  • brew install formula — for macOS Linux-via-VM users who want the same CLI surface.

PRs welcome. Open one against main with a green CI run.

License

MIT — © 2026 Rotem Dadon.