ClaudeCast

Continue your Claude Code session from any device. Wraps Claude Code + tmux + ttyd + Cloudflare Tunnel into a single command.

claudecast

Opens Claude Code locally and exposes it via a public URL — accessible from your phone, tablet, or another computer.

Install

npm install -g @dhyey2075/claudecast

Prerequisites

• Claude Code — npm install -g @anthropic-ai/claude-code
• tmux — brew install tmux
• ttyd — brew install ttyd
• cloudflared — brew install cloudflare/cloudflare/cloudflared

Usage

# Start Claude with web access + public tunnel
claudecast

# Named session
claudecast --session SURFF-1017

# Resume an existing session
claudecast --resume

# Continue last conversation
claudecast -c

# Local only, no tunnel
claudecast --no-tunnel

# No web at all, just tmux
claudecast --no-web

# Custom port
claudecast --port 8080

# Pass any Claude CLI flags
claudecast --model sonnet
claudecast --dangerously-skip-permissions

Commands

# Check what's running
claudecast status

# Stop web services (keeps Claude session alive)
claudecast stop

# Stop everything
claudecast stop --all

How It Works

claudecast
    │
    ├── tmux session (claude)        ← Claude Code runs here
    ├── tmux session (ttyd)          ← Web terminal server
    └── tmux session (tunnel)        ← Cloudflare Tunnel

• Claude runs inside a tmux session
• ttyd exposes that session as a web terminal
• Cloudflare Tunnel gives it a public HTTPS URL
• Your local terminal and the web view are mirrored
• When you exit Claude, everything cleans up automatically

Options

| Flag | Description | |------|-------------| | --session <name> | Name the tmux session (default: claude) | | --port <port> | ttyd port (default: 7681) | | --no-web | Skip ttyd and tunnel, local tmux only | | --no-tunnel | Start ttyd but skip Cloudflare tunnel | | --local-only | Bind ttyd to localhost only | | --help | Show help |

All other flags are forwarded directly to Claude CLI.

Security

The public URL gives full terminal access to anyone who has it. A warning is displayed on startup. For production use, consider:

• Using --no-tunnel for local-only access
• Using --local-only to restrict to localhost
• Setting up a named Cloudflare Tunnel with Access policies

License

MIT