v2.0: Complete P2P Rewrite — Your terminal data never touches any server. Direct encrypted connection between your phone and PC.

GhostTerm is a mobile companion for Claude Code that gives you full terminal access from your phone over a direct peer-to-peer connection.

Why GhostTerm?

Run Claude Code in Dangerous Mode — From Your Phone

claude --dangerously-skip-permissions

The official Claude Code mobile app doesn't support --dangerously-skip-permissions. GhostTerm gives you full terminal access, so you can launch Claude in fully autonomous mode and let it work while you're away from your desk. One tap to start, one tap to stop.

Not Just Claude — Full Terminal Access

GhostTerm isn't limited to Claude Code. It's a complete remote terminal. Run any command — git, npm, python, vim, docker, anything your terminal can do. The official app only gives you Claude.

4 Terminals at Once

Run up to 4 concurrent terminal sessions with ghost cell tabs. Have Claude Code running in one, a dev server in another, git in the third. Switch between them instantly. The official app gives you one.

See Everything at a Glance — Pixel Office

A unique animated workspace shows all your terminal sessions as pixel ghosts. See which ones are busy, idle, or waiting for input — without switching tabs. Know exactly what's happening on your PC from a single screen.

Encrypted Direct Connection

The remote control link between your phone and PC is a direct WebRTC connection with DTLS encryption. Your keystrokes and terminal output travel straight between devices — they never pass through GhostTerm's servers or any third party.

• How it works: Phone ↔ PC direct (the signaling server only helps with pairing, then gets out of the way)
• What's encrypted: Everything you see and type in the remote terminal session

Send Files from Phone to PC

Take a photo, pick a file, and send it straight to your PC terminal. Then tap paste to insert the file path. Perfect for sharing screenshots of bugs, uploading configs, or sending reference images to Claude.

One-Tap Controls

Purpose-built buttons for Claude Code workflows:

• y / n — approve or deny permission prompts instantly
• claude — launch Claude Code with one tap
• Stop — send Ctrl+C immediately
• Arrow keys, Tab, Escape — all one tap, no keyboard fumbling

Quick Start

Install once:

npm install -g ghostterm

Then just run:

ghostterm

1. First time: browser opens for Google sign-in (one-time, remembered after)
2. Open ghostterm.pages.dev on your phone
3. Sign in with the same Google account → auto-connects or enter the 10-digit pairing code

Don't want to install? Use npx ghostterm to run without installing.

Security

Phone ──── WebRTC DataChannel (DTLS encrypted) ────── PC
                        │
                  (pairing only)
                        │
               Signaling Server
        (exchanges connection info, never sees terminal data)

• DTLS encryption on all terminal data — end-to-end, no exceptions
• No data at rest — the signaling server stores nothing
• Google OAuth — verified identity for secure auto-pairing
• Brute force protection — 3 wrong codes = 60s lockout
• Private beta — access controlled by email whitelist

Options

npx ghostterm [options]

  -s, --signal <url>   Custom signaling server URL
  --site <url>         Custom mobile site URL
  -h, --help           Show help

Requirements

• Node.js 18+ on your PC
• Modern browser on your phone (Safari, Chrome, Firefox)
• Google account for auto-pairing

Links

• Mobile App: ghostterm.pages.dev
• npm: npmjs.com/package/ghostterm