PkgFoundry
Catalog npm
Back to packageRELEASE DETAILS

2.0.41

npm

9remote-beta

Remote terminal access from anywhere

cliremotesshterminal
Published2 Jul 2026
Direct dependencies34
Transitive dependenciesNot calculated

README

Current package documentation
9Remote

9Remote — Terminal in Your Pocket

Your Mac/Linux/Windows terminal, remote desktop, and file explorer — accessible from any phone or browser, anywhere, instantly.

npm version Downloads License

🚀 Quick Start • 💡 Features • 🌐 Website • 📖 Docs

🤔 Why 9Remote?

Remote access today is painful:

  • ❌ SSH — firewall rules, port forwarding, SSH keys
  • ❌ VPN — overkill just to check a terminal
  • ❌ ngrok / tunnels — expire, lose connection
  • ❌ TeamViewer — slow, desktop-only, paid
  • ❌ Termius — SSH-only, no desktop, no browser

9Remote solves all of it:

  • ✅ One command — install, scan QR, done in 30 seconds
  • ✅ Auto tunnel — Cloudflare tunnel, no port forwarding
  • ✅ All-in-one — terminal + desktop + file explorer + editor
  • ✅ Works on phone — full workspace from browser, <50ms latency
  • ✅ Persistent — PTY sessions survive restarts
  • ✅ Pair Device — only approved devices connect, zero signup

⚡ Quick Start

npm install -g 9remote
9remote

🎉 Scan the QR → pair your device → you're in.

Works on macOS, Linux, Windows. Requires Node.js 20+.

CLI Commands

CommandDescription
9remoteTUI mode — interactive menu with QR code
9remote uiWeb UI mode — opens dashboard at localhost:2208

✨ Features

FeatureWhat It Does
🖥️ Remote TerminalFull PTY shell via WebSocket
🖱️ Remote DesktopLive screen streaming via WebRTC
📁 File ExplorerBrowse, upload, download files
💻 Code EditorBuilt-in editor with syntax highlighting
🔗 Git IntegrationRun git commands with visual status
📱 Mobile OptimizedTouch-friendly UI, gesture controls
🔑 QR LoginOne-time 30-min key, scan to connect
🔒 Auto TunnelCloudflare tunnel, no port forwarding
🔄 Persistent SessionsPTY daemon survives restarts
🌍 Multi-Device SyncSame session across phone/tablet/laptop
🔔 Push NotificationsBuild finished? Get notified
🤖 AI IntegrationClaude Code, Codex, Cursor, OpenClaw
🌐 Local Sites ProxyExpose localhost:3000 to phone
🔐 Pair DeviceApprove each device before it connects
🆓 No AccountMachine ID + QR key, zero signup

🎯 Use Cases

Code from bed — 11 PM, bug in prod, laptop in another room? Open the app on your phone, scan QR, fix, push, sleep.

Fix bugs at a cafe — Production down, only phone + café Wi-Fi? Connect to your home Mac, tail logs, edit config, deploy.

Deploy on vacation — Client needs a hotfix, you're on the beach? Phone → 9remote → git pull → deploy → back to the beach.

On-call engineer — 3 AM alert, don't want to boot laptop? Push notification → terminal + remote desktop from bed.

📖 Setup

🔑 First Run & QR Login

On first run, 9Remote generates two keys:

  • Permanent Key — stored locally, tied to your machine ID
  • One-Time Key — 30-minute temporary key for the QR code

Connect from phone:

  1. Run 9remote on your machine
  2. A QR code appears in the terminal
  3. Open 9remote.cc on your phone (or the mobile app)
  4. Scan the QR → connected instantly

Keys are never stored on our servers after the session ends.

🖱️ Remote Desktop (macOS)

Requires two system permissions:

  1. Screen Recording — System Settings → Privacy & Security → Screen Recording
  2. Accessibility — System Settings → Privacy & Security → Accessibility

Enable Terminal (or the app you ran 9remote from), then toggle Remote Desktop in the TUI menu.

Performance:

  • Adaptive framerate: 60ms active / 400ms idle
  • Tile-based diff rendering (only changed regions sent)
  • WebRTC DataChannel for minimal latency
🌐 Local Sites Proxy

Expose your local dev servers automatically:

http://localhost:3000  →  https://<tunnel>/proxy/3000/
http://localhost:5173  →  https://<tunnel>/proxy/5173/

Perfect for testing responsive design on real devices, sharing WIP builds, or mobile debugging without USB.

❓ FAQ

🔒 Is it secure?

Yes. Every new device must be explicitly approved via Pair Device before it can access the host. Plus:

  • No open ports — Cloudflare tunnel is outbound-only
  • Keys never stored on our servers after session ends
  • No terminal output, files, or screen data collected
  • One-time QR keys expire in 30 minutes
💰 Is it free?

Yes. Free to use, no signup, no credit card. MIT licensed.

🌐 Do I need to open ports?

No. Uses Cloudflare Quick Tunnel — outbound only. Works behind home NAT, corporate firewalls, mobile hotspots, VPNs.

📴 Does it work on LAN only?

Yes. A LocalFirstAdapter races LAN vs tunnel and uses whichever is faster. If phone and host share the same Wi-Fi, traffic stays local.

🤖 Can I use AI coding tools through 9Remote?

Yes. Works seamlessly with Claude Code, OpenAI Codex CLI, Cursor, OpenClaw, and any CLI tool. Run them on your host, access from your phone.

🖥️ What platforms are supported?

Host: macOS (Intel + Apple Silicon), Linux (x64, arm64), Windows (x64) Client: Any modern browser, iOS 14+, Android 8+

🐛 Troubleshooting

"Port 2208 already in use"

  • Another instance running → pkill -f 9remote and retry
  • Or use a different port: PORT=3308 9remote

"Cloudflare tunnel failed to start"

  • Check internet connection
  • cloudflared auto-installed on first run; otherwise install manually from cloudflared docs

"Screen Recording / Accessibility denied" (macOS)

  • Grant permissions in System Settings → Privacy & Security, then restart 9Remote

"QR code expired"

  • Keys expire in 30 minutes → regenerate from TUI menu: Key → Regenerate

"Can't connect from phone"

  • Check both devices have internet
  • Try forcing tunnel mode: Settings → Connection → Tunnel only

📧 Links

📄 License

MIT © 9Team

Built with ❤️ for developers who code from anywhere — bed, beach, or bus.

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 34

Native requirements
34 direct targetsNot calculated transitive count
Package / targetRequirementRelationship
ora
Environment
{
  "local_name": "ora",
  "alias": false,
  "peer_metadata": null
}
^8.1.1runtime
chalk
Environment
{
  "local_name": "chalk",
  "alias": false,
  "peer_metadata": null
}
^5.4.1runtime
sharp
Environment
{
  "local_name": "sharp",
  "alias": false,
  "peer_metadata": null
}
^0.33.5runtime
preact
Environment
{
  "local_name": "preact",
  "alias": false,
  "peer_metadata": null
}
^10.26.2runtime
qrcode
Environment
{
  "local_name": "qrcode",
  "alias": false,
  "peer_metadata": null
}
^1.5.4runtime
chokidar
Environment
{
  "local_name": "chokidar",
  "alias": false,
  "peer_metadata": null
}
^3.6.0runtime
inquirer
Environment
{
  "local_name": "inquirer",
  "alias": false,
  "peer_metadata": null
}
^9.3.8runtime
web-push
Environment
{
  "local_name": "web-push",
  "alias": false,
  "peer_metadata": null
}
^3.6.7runtime
socket.io
Environment
{
  "local_name": "socket.io",
  "alias": false,
  "peer_metadata": null
}
^4.8.3runtime
bufferutil
Environment
{
  "local_name": "bufferutil",
  "alias": false,
  "peer_metadata": null
}
^4.1.0runtime
http-proxy
Environment
{
  "local_name": "http-proxy",
  "alias": false,
  "peer_metadata": null
}
^1.18.1runtime
@xterm/xterm
Environment
{
  "local_name": "@xterm/xterm",
  "alias": false,
  "peer_metadata": null
}
^6.0.0runtime
edge-tts-node
Environment
{
  "local_name": "edge-tts-node",
  "alias": false,
  "peer_metadata": null
}
^1.5.7runtime
multicast-dns
Environment
{
  "local_name": "multicast-dns",
  "alias": false,
  "peer_metadata": null
}
^7.2.5runtime
utf-8-validate
Environment
{
  "local_name": "utf-8-validate",
  "alias": false,
  "peer_metadata": null
}
^6.0.6runtime
node-machine-id
Environment
{
  "local_name": "node-machine-id",
  "alias": false,
  "peer_metadata": null
}
^1.1.12runtime
qrcode-terminal
Environment
{
  "local_name": "qrcode-terminal",
  "alias": false,
  "peer_metadata": null
}
^0.12.0runtime
@xterm/addon-fit
Environment
{
  "local_name": "@xterm/addon-fit",
  "alias": false,
  "peer_metadata": null
}
^0.11.0runtime
node-datachannel
Environment
{
  "local_name": "node-datachannel",
  "alias": false,
  "peer_metadata": null
}
^0.32.3runtime
node-screenshots
Environment
{
  "local_name": "node-screenshots",
  "alias": false,
  "peer_metadata": null
}
^0.2.8runtime
socket.io-client
Environment
{
  "local_name": "socket.io-client",
  "alias": false,
  "peer_metadata": null
}
^4.8.3runtime
@julusian/jpeg-turbo
Environment
{
  "local_name": "@julusian/jpeg-turbo",
  "alias": false,
  "peer_metadata": null
}
^3.0.1runtime
@xterm/addon-unicode11
Environment
{
  "local_name": "@xterm/addon-unicode11",
  "alias": false,
  "peer_metadata": null
}
^0.9.0runtime
vite
Environment
{
  "local_name": "vite",
  "alias": false,
  "peer_metadata": null
}
^6.2.2development
nodemon
Environment
{
  "local_name": "nodemon",
  "alias": false,
  "peer_metadata": null
}
^3.1.11development
postcss
Environment
{
  "local_name": "postcss",
  "alias": false,
  "peer_metadata": null
}
^8.5.3development
wait-on
Environment
{
  "local_name": "wait-on",
  "alias": false,
  "peer_metadata": null
}
^9.0.4development
npm-run-all
Environment
{
  "local_name": "npm-run-all",
  "alias": false,
  "peer_metadata": null
}
^4.1.5development
tailwindcss
Environment
{
  "local_name": "tailwindcss",
  "alias": false,
  "peer_metadata": null
}
^3.4.17development
autoprefixer
Environment
{
  "local_name": "autoprefixer",
  "alias": false,
  "peer_metadata": null
}
^10.4.21development
@preact/preset-vite
Environment
{
  "local_name": "@preact/preset-vite",
  "alias": false,
  "peer_metadata": null
}
^2.9.5development
vite-plugin-javascript-obfuscator
Environment
{
  "local_name": "vite-plugin-javascript-obfuscator",
  "alias": false,
  "peer_metadata": null
}
^3.1.0development
node-pty
Environment
{
  "local_name": "node-pty",
  "alias": false,
  "peer_metadata": null
}
1.2.0-beta.12optional
@hurdlegroup/robotjs
Environment
{
  "local_name": "@hurdlegroup/robotjs",
  "alias": false,
  "peer_metadata": null
}
^0.12.1optional

Distribution files

1 collected
Distribution 1

Source distribution

Source file
Checksums from source
{
  "shasum": "390181b3016a3faacaa9fe5e6439ebf3b71a7279",
  "tarball": "https://registry.npmjs.org/9remote-beta/-/9remote-beta-2.0.41.tgz",
  "fileCount": 16,
  "integrity": "sha512-5gXK9kOyURw0rotvvfYMcGyeYOvAniRFPPfleVejBd837qCIU2w7q8u44rpsfSYtKGlJcGBbIZ07xJ75vpqoyw==",
  "signatures": [
    {
      "sig": "MEUCIQDQ/YEsg0f0c4LOYHVd44i2yj70O7+7RdDbio/o7l6vdgIgEqhc7FDPdAhEzNCMZUVOa+3pPWiUKbp2Y0SMp2Qr/2E=",
      "keyid": "SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"
    }
  ],
  "unpackedSize": 2192137
}

Metadata history

Meaningful changes
Current collected state Current

Observed since 20 Oct, 21:40 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:7d6ccc9cc35eb2f67fcd2be9816fd20be3004e49301d9941309232dbe4436b0e

Other collected versions

2.0.552 Jul2.0.542 Jul2.0.532 Jul2.0.522 Jul2.0.512 Jul2.0.502 JulView all collected versions →