Control Claude Code from your phone. Send prompts, chat with projects, execute terminal commands — all from a mobile-friendly web UI tunneled through ngrok.
Features
Mobile-first web UI — responsive design for phone, tablet, and laptop
Project-based chat — create projects with isolated conversation history
Claude CLI integration — uses your existing Claude Code auth, no API key needed
Terminal execution — run commands in VS Code terminal from your phone
ngrok tunneling — built-in ngrok setup to access from anywhere
Setup wizard — checks Claude CLI, ngrok, and workspace folder on first launch
Quick Start
Install the extension
Open Command Palette → PocketClaude: Start Server
Choose your workspace folder when prompted
Open the web UI at http://localhost:7532 (or your ngrok URL)
Login with the admin token shown in VS Code
Commands
Command
Description
PocketClaude: Start Server
Start the HTTP server with setup wizard
PocketClaude: Stop Server
Stop server and ngrok tunnel
PocketClaude: Setup ngrok
Configure and start ngrok tunnel
PocketClaude: Change Working Folder
Change Claude's working directory
PocketClaude: Show Connection Info
Show server URL, token, and ngrok status
Settings
Setting
Default
Description
pocketclaude.port
7532
HTTP server port
pocketclaude.authToken
""
Admin bearer token (auto-generated if empty)
pocketclaude.autoExecute
false
Auto-execute terminal commands from Claude
pocketclaude.ngrokAuthToken
""
ngrok auth token for automatic tunnel setup
pocketclaude.ngrokAutoStart
false
Auto-start ngrok when server starts
API Endpoints
All endpoints (except /status and /setup) require Authorization: Bearer <token> header.
