Walkie Talkie Bot

A walkie talkie for Claude. Your voice is the interface.

Website: walkietalkie.bot -- Docs: walkietalkie.bot/docs

Requirements

• Node.js 20.19 or later (or 22.12+)
• Claude Code CLI, installed and logged in, with claude on your PATH. Every message goes through it; there is no API-key mode.
• Chrome or Edge for voice (Web Speech API). Other browsers can still type.

Install

Two ways to use Walkie Talkie Bot. Pick one (or both).

MCP tools only (no server)

Register the MCP server with Claude Code for 30 tools. The 15 data tools talk directly to SQLite, so no server is required for them.

claude mcp add --scope user wtb -- npx -y -p walkietalkiebot wtb-mcp

Or, to share it with a project, add it to that project's .mcp.json:

{
  "mcpServers": {
    "wtb": {
      "command": "npx",
      "args": ["-y", "-p", "walkietalkiebot", "wtb-mcp"]
    }
  }
}

Do not run npx wtb-mcp. The wtb-mcp package on npm belongs to an unrelated third party. The Talkie binary ships inside the walkietalkiebot package, which is why the command needs -p walkietalkiebot.

The five skills (below) ship with the Claude Code plugin manifest in this repository (.claude-plugin/, skills/).

Full install

The full server gives you the web UI, voice interface, and everything. Run it from the project directory you want Claude to work in:

cd ~/code/my-project
npx walkietalkiebot

This starts the server on 127.0.0.1:5173 and opens http://localhost:5173 in your browser. Claude runs in that directory with bypassPermissions, so it can edit files and run commands there without asking. Read Security before exposing the server to anything but your own machine.

What You Get

MCP tools

• 15 data tools -- conversations, messages, plans, search, liner notes, export. Always work via direct SQLite, no server needed.
• 15 server tools -- voice, IPC, sessions, jobs, image analysis, browser control. Require the Walkie Talkie Bot server to be running.
• 5 skills (with the Claude Code plugin) -- save-conversation, search-tapes, manage-plans, launch-voice, export-tape.

Full Install

Everything above, plus:

• Web UI with 6 retro themes and cassette tape metaphor
• Push-to-talk, wake word ("hey talkie"), and continuous listening
• Streaming text-to-speech with selectable system voices
• Animated robot avatar with 6 states
• Real-time activity feed for Claude Code tool calls
• Automatic plan detection and management
• Per-conversation liner notes
• Full-text search across all conversations (Cmd+K)
• Background job execution with SSE streaming
• Image drag-and-drop with Claude vision analysis
• Markdown and JSON export

Themes

Six fully themed visual experiences. Every UI element reskins -- headers, chat bubbles, conversation cards, viewport borders, modals, and the robot avatar.

Theme	Internal Name	Vibe
TalkBoy	mccallister	Silver cassette recorder with chunky buttons and red accents
Bubble	imessage	Minimal and polished, inspired by modern Apple interfaces
Dial-Up	aol	Beveled gray panels and buddy list energy from the 90s internet
Finder	classic-mac	The elegant gray desktop of classic Mac OS (System 7/8/9)
Guestbook	geocities	Neon text on dark backgrounds, like a 90s homepage under construction
1984	apple-1984	Rainbow Apple warmth from the original Macintosh era

Switch themes via the header button or settings drawer.

MCP Tools

Data Tools (offline)

Work directly against SQLite at ~/.wtb/wtb.db. No server needed.

Tool	Description
list_conversations	List all saved conversations with pagination
get_conversation	Get full conversation with messages, images, and activities
create_conversation	Create a new conversation (cassette tape)
rename_conversation	Rename an existing conversation
delete_conversation	Delete a conversation permanently
search_conversations	Full-text search (FTS5) across all conversations
add_message	Add a message to a conversation
list_plans	List all plans
get_plan	Get plan by ID with full content
create_plan	Create a plan (draft/approved/in_progress/completed/archived)
update_plan	Update plan title, content, or status
delete_plan	Delete a plan
get_liner_notes	Get per-conversation markdown notes
set_liner_notes	Set or clear liner notes
export_conversation	Export as markdown or JSON

Server Tools (requires server)

Require the Walkie Talkie Bot server to be running (npx walkietalkiebot).

Tool	Description
launch_wtb	Start server and open browser
get_wtb_status	Check running status and avatar state
get_transcript	Get latest voice transcript
get_conversation_history	Get current tape's conversation messages
get_claude_session	Get connected session ID
set_claude_session	Connect to a Claude Code session
disconnect_claude_session	Disconnect session
get_pending_message	Poll for user messages (IPC mode)
respond_to_wtb	Send response to user (IPC mode)
update_wtb_state	Set avatar state and transcript
analyze_image	Analyze image via Claude vision
open_url	Open URL in default browser
create_wtb_job	Create background async job
get_wtb_job	Get job status and result
list_wtb_jobs	List jobs by status

This is the beginning of the README. Read the rest at the original. Read the full README ↗