claude-pocket
v1.0.3
Published
Hop between Claude Code sessions from your phone — mobile dashboard with tmux window management
Maintainers
Readme
Claude Pocket
Control Claude Code sessions from your phone.
Mobile-optimized dashboard with tmux window management, action buttons (Ctrl-C, Esc, Enter, arrows), text input, and an SSH tunnel for remote access through VPNs.
Features
- Mobile dashboard — Tokyo Night themed, touch-optimized UI with live ANSI terminal output
- Session management — switch between Claude Code sessions via tmux windows; swipe to kill
- Remote access — automatic SSH tunnel via localhost.run, with QR code for quick connect
- MFA — 6-digit code shown in terminal, invalidated on every wrong guess
- Full terminal — embedded ttyd terminal for when you need the real thing
Prerequisites
| Tool | Install |
|------|---------|
| Claude Code | npm install -g @anthropic-ai/claude-code |
| tmux | sudo apt install tmux |
| ttyd | sudo apt install ttyd |
| Node.js 18+ | nodejs.org |
| SSH client | sudo apt install openssh-client |
Install
npm pack
npm install -g claude-pocket-*.tgzUsage
claude-pocket # start, scan QR to connect
claude-pocket -f 24 # larger terminal font
claude-pocket -T # LAN only, no tunnel
claude-pocket -k # stop everythingOptions:
| Flag | Description |
|------|-------------|
| -p PORT | Dashboard port (default: 7682) |
| -P PORT | Terminal port (default: 7683) |
| -f SIZE | Terminal font size (default: 18) |
| -t | Force tunnel (fail if SSH unavailable) |
| -T | Disable tunnel (LAN only) |
| -k | Kill a running session |
How it works
- Starts a tmux session and ttyd web terminal
- Launches a Node.js server with the mobile dashboard and API
- Opens an SSH tunnel via localhost.run for public access
- Displays a QR code — scan it from your phone
- Enter the MFA code shown in the terminal
From the dashboard you can read Claude's output, send messages, use action buttons, and manage multiple sessions from the hamburger menu.
Environment variables
| Variable | Default | Description |
|----------|---------|-------------|
| CLAUDE_POCKET_PORT | 7682 | Dashboard server port |
| CLAUDE_POCKET_TTYD_PORT | 7683 | ttyd terminal port |
| CLAUDE_POCKET_TOKEN | random | URL token (auto-generated) |
| CLAUDE_POCKET_TMUX_SESSION | claude-pocket | tmux session name |
| CLAUDE_POCKET_TUNNEL | auto | auto, on, or off |
| CLAUDE_POCKET_FONT_SIZE | 18 | Terminal font size |
License
MIT
