HeyClaude

Bidirectional voice remote control for Claude Code. Talk to Claude Code from your phone.

How it works

1. Server runs on your computer alongside Claude Code
2. Phone connects via browser — you speak, Claude responds with voice
3. Uses the Claude Agent SDK for a persistent, multi-turn coding session

Quick start

bun install
bun run start

Open http://localhost:3456 in your phone's browser (same WiFi network).

HTTPS (required for microphone on mobile)

The Web Speech API requires HTTPS on mobile browsers. Use ngrok:

npx ngrok http 3456

Then open the ngrok HTTPS URL on your phone. You can also "Add to Home Screen" for a native app feel.

Features

• Voice input — tap the mic button and speak
• Voice output — Claude's responses are read aloud via TTS
• Permission control — approve/deny tool use from your phone
• Keyboard fallback — text input when voice isn't available
• Interrupt — stop Claude mid-response
• PWA — add to home screen for a native app experience

Architecture

Phone (Browser)              Your Computer (Bun server)
┌─────────────────┐          ┌─────────────────────────┐
│ Web Speech API  │          │ WebSocket Server        │
│ (STT + TTS)    │◄──WSS──►│ Claude Agent SDK         │
│ PWA UI         │          │ (persistent session)     │
└─────────────────┘          └─────────────────────────┘