walkietalkiebot 0.3.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,8 @@
+{
+  "name": "wtb",
+  "description": "Walkie Talkie Bot — voice-first cassette tape interface for Claude Code. 30 MCP tools for conversations, plans, search, voice, and more. Data tools work offline via direct SQLite.",
+  "version": "0.3.0",
+  "author": { "name": "Ben Gillin" },
+  "homepage": "https://walkietalkie.bot",
+  "repository": "https://github.com/bengillin/walkietalkiebot"
+}

package/.mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "wtb": {
+      "command": "node",
+      "args": ["${CLAUDE_PLUGIN_ROOT}/mcp-server/dist/index.js"]
+    }
+  }
+}

package/README.md

@@ -0,0 +1,169 @@
+# Walkie Talkie Bot
+
+[![npm version](https://img.shields.io/npm/v/walkietalkiebot.svg)](https://www.npmjs.com/package/walkietalkiebot) [![npm downloads](https://img.shields.io/npm/dm/walkietalkiebot.svg)](https://www.npmjs.com/package/walkietalkiebot)
+
+A walkie talkie for Claude. Your voice is the interface.
+
+> **Website**: [walkietalkie.bot](https://walkietalkie.bot) -- **Docs**: [walkietalkie.bot/docs](https://walkietalkie.bot/docs/)
+
+## Install
+
+Two ways to use Walkie Talkie Bot. Pick one (or both).
+
+### Plugin (recommended)
+
+Add Walkie Talkie Bot as a Claude Code plugin for 30 MCP tools + 5 skills, no server required. Data tools talk directly to SQLite.
+
+Add to `~/.claude/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "wtb": {
+      "command": "npx",
+      "args": ["wtb-mcp"]
+    }
+  }
+}
+```
+
+### Full Install
+
+The full server gives you the web UI, voice interface, Telegram bot, and everything.
+
+```bash
+npx walkietalkiebot
+```
+
+This starts the HTTPS server and opens `https://localhost:5173` in your browser.
+
+> Requires Chrome or Edge for voice (Web Speech API needs secure context).
+
+## What You Get
+
+### Plugin
+
+- **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** -- 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
+- Telegram bot integration
+- 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 |
+
+### Skills
+
+| Skill | Description |
+|-------|-------------|
+| `save-conversation` | Save the current conversation as a cassette tape |
+| `search-tapes` | Search across all saved tapes |
+| `manage-plans` | Create, update, and track plans |
+| `launch-voice` | Start the voice interface |
+| `export-tape` | Export a conversation to markdown or JSON |
+
+## Configuration
+
+Set `WTB_PORT` to change the default port (5173).
+
+**Server management:**
+
+```bash
+wtb-server start [-f]    # Start (background or foreground)
+wtb-server stop           # Stop
+wtb-server status         # Show status
+wtb-server logs [-f]      # View logs
+wtb-server install        # Install as macOS launchd daemon
+```
+
+**Telegram bot:** Create a bot via [@BotFather](https://t.me/BotFather), then set `TELEGRAM_BOT_TOKEN` or save to `~/.wtb/telegram.token`. The bot starts automatically with the server.
+
+## Development
+
+```bash
+npm install       # Install dependencies
+npm run dev       # Vite dev server (frontend only)
+npm run build     # TypeScript check + Vite build + server bundle + MCP server
+npm run test      # Run all tests (140 tests across 10 files)
+```
+
+The frontend is decomposed into custom hooks (`src/hooks/`) for voice I/O, Claude chat, keyboard control, FAB dragging, image analysis, and server sync. The server has full test coverage for all database repositories and HTTP API endpoints.
+
+Full architecture, API reference, and integration guides at [walkietalkie.bot/docs](https://walkietalkie.bot/docs/).
+
+## License
+
+MIT

package/bin/wtb-server.js

@@ -0,0 +1,336 @@
+#!/usr/bin/env node
+
+import { spawn, execSync } from 'child_process'
+import { existsSync, mkdirSync, writeFileSync, readFileSync, unlinkSync, createReadStream } from 'fs'
+import { join, dirname } from 'path'
+import { homedir } from 'os'
+import { fileURLToPath } from 'url'
+import { createInterface } from 'readline'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const PLIST_NAME = 'com.wtb.server'
+const PLIST_PATH = join(homedir(), 'Library', 'LaunchAgents', `${PLIST_NAME}.plist`)
+const LOG_DIR = join(homedir(), '.wtb', 'logs')
+const PID_FILE = join(homedir(), '.wtb', 'server.pid')
+const PORT = parseInt(process.env.WTB_PORT || '5173', 10)
+
+function ensureDirs() {
+  const wtbDir = join(homedir(), '.wtb')
+  if (!existsSync(wtbDir)) {
+    mkdirSync(wtbDir, { recursive: true })
+  }
+  if (!existsSync(LOG_DIR)) {
+    mkdirSync(LOG_DIR, { recursive: true })
+  }
+  const launchAgentsDir = dirname(PLIST_PATH)
+  if (!existsSync(launchAgentsDir)) {
+    mkdirSync(launchAgentsDir, { recursive: true })
+  }
+}
+
+function generatePlist() {
+  const serverScript = join(__dirname, '..', 'server', 'index.js')
+
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>Label</key>
+    <string>${PLIST_NAME}</string>
+    <key>ProgramArguments</key>
+    <array>
+        <string>/usr/bin/env</string>
+        <string>node</string>
+        <string>${serverScript}</string>
+    </array>
+    <key>EnvironmentVariables</key>
+    <dict>
+        <key>PORT</key>
+        <string>${PORT}</string>
+        <key>PATH</key>
+        <string>/usr/local/bin:/usr/bin:/bin:/opt/homebrew/bin</string>
+    </dict>
+    <key>WorkingDirectory</key>
+    <string>${join(__dirname, '..')}</string>
+    <key>RunAtLoad</key>
+    <true/>
+    <key>KeepAlive</key>
+    <true/>
+    <key>StandardOutPath</key>
+    <string>${join(LOG_DIR, 'stdout.log')}</string>
+    <key>StandardErrorPath</key>
+    <string>${join(LOG_DIR, 'stderr.log')}</string>
+</dict>
+</plist>`
+}
+
+function isLaunchctlLoaded() {
+  try {
+    const result = execSync(`launchctl list ${PLIST_NAME} 2>/dev/null`, { encoding: 'utf-8' })
+    return result.includes(PLIST_NAME)
+  } catch {
+    return false
+  }
+}
+
+function isServerRunning() {
+  try {
+    execSync(`curl -s -k https://localhost:${PORT}/api/status`, { encoding: 'utf-8' })
+    return true
+  } catch {
+    return false
+  }
+}
+
+function getPid() {
+  if (existsSync(PID_FILE)) {
+    return parseInt(readFileSync(PID_FILE, 'utf-8').trim(), 10)
+  }
+  return null
+}
+
+async function commands() {
+  const cmd = process.argv[2]
+  const args = process.argv.slice(3)
+
+  switch (cmd) {
+    case 'start':
+      await startServer(args.includes('--foreground') || args.includes('-f'))
+      break
+
+    case 'stop':
+      await stopServer()
+      break
+
+    case 'restart':
+      await stopServer()
+      await startServer(false)
+      break
+
+    case 'status':
+      await showStatus()
+      break
+
+    case 'logs':
+      await showLogs(args.includes('--follow') || args.includes('-f'))
+      break
+
+    case 'install':
+      await installDaemon()
+      break
+
+    case 'uninstall':
+      await uninstallDaemon()
+      break
+
+    default:
+      showHelp()
+  }
+}
+
+async function startServer(foreground = false) {
+  ensureDirs()
+
+  if (isServerRunning()) {
+    console.log('Server is already running.')
+    return
+  }
+
+  if (foreground) {
+    console.log(`Starting Walkie Talkie Bot server in foreground on port ${PORT}...`)
+    const { startServer } = await import('../server/index.js')
+    await startServer(PORT)
+  } else {
+    // Check if launchd plist is installed
+    if (existsSync(PLIST_PATH)) {
+      console.log('Starting via launchd...')
+      execSync(`launchctl load ${PLIST_PATH}`)
+    } else {
+      // Start as background process
+      console.log('Starting as background process...')
+      const serverScript = join(__dirname, '..', 'server', 'index.js')
+      const child = spawn('node', [serverScript], {
+        detached: true,
+        stdio: ['ignore', 'pipe', 'pipe'],
+        env: { ...process.env, PORT: String(PORT) },
+        cwd: join(__dirname, '..'),
+      })
+
+      // Save PID
+      writeFileSync(PID_FILE, String(child.pid))
+
+      // Pipe logs
+      const stdout = createWriteStream(join(LOG_DIR, 'stdout.log'), { flags: 'a' })
+      const stderr = createWriteStream(join(LOG_DIR, 'stderr.log'), { flags: 'a' })
+      child.stdout?.pipe(stdout)
+      child.stderr?.pipe(stderr)
+
+      child.unref()
+    }
+
+    // Wait for server to be ready
+    console.log('Waiting for server to start...')
+    for (let i = 0; i < 30; i++) {
+      await new Promise(r => setTimeout(r, 500))
+      if (isServerRunning()) {
+        console.log(`Walkie Talkie Bot server running at https://localhost:${PORT}`)
+        return
+      }
+    }
+
+    console.error('Server failed to start. Check logs with: wtb-server logs')
+  }
+}
+
+async function stopServer() {
+  if (isLaunchctlLoaded()) {
+    console.log('Stopping via launchd...')
+    try {
+      execSync(`launchctl unload ${PLIST_PATH}`)
+    } catch {
+      // Ignore errors
+    }
+  }
+
+  const pid = getPid()
+  if (pid) {
+    console.log(`Stopping process ${pid}...`)
+    try {
+      process.kill(pid, 'SIGTERM')
+      unlinkSync(PID_FILE)
+    } catch {
+      // Process may already be dead
+    }
+  }
+
+  // Wait for server to stop
+  for (let i = 0; i < 10; i++) {
+    await new Promise(r => setTimeout(r, 500))
+    if (!isServerRunning()) {
+      console.log('Server stopped.')
+      return
+    }
+  }
+
+  if (isServerRunning()) {
+    console.log('Warning: Server may still be running.')
+  } else {
+    console.log('Server stopped.')
+  }
+}
+
+async function showStatus() {
+  const running = isServerRunning()
+  const launchd = isLaunchctlLoaded()
+
+  console.log('Walkie Talkie Bot Server Status')
+  console.log('================================')
+  console.log(`Server:   ${running ? '✅ Running' : '❌ Stopped'}`)
+  console.log(`Port:     ${PORT}`)
+  console.log(`launchd:  ${launchd ? '✅ Loaded' : '⚪ Not loaded'}`)
+  console.log(`Plist:    ${existsSync(PLIST_PATH) ? '✅ Installed' : '⚪ Not installed'}`)
+
+  if (running) {
+    try {
+      const response = await fetch(`https://localhost:${PORT}/api/status`, {
+        // @ts-expect-error
+        agent: new (await import('https')).Agent({ rejectUnauthorized: false })
+      })
+      const data = await response.json()
+      console.log(`Database: ${data.dbStatus === 'connected' ? '✅ Connected' : '⚠️ Unavailable'}`)
+      console.log(`Avatar:   ${data.avatarState}`)
+    } catch {
+      // Ignore
+    }
+  }
+}
+
+async function showLogs(follow = false) {
+  const logFile = join(LOG_DIR, 'stdout.log')
+  const errFile = join(LOG_DIR, 'stderr.log')
+
+  if (!existsSync(logFile) && !existsSync(errFile)) {
+    console.log('No logs found.')
+    return
+  }
+
+  if (follow) {
+    console.log('Following logs (Ctrl+C to stop)...\n')
+    const tail = spawn('tail', ['-f', logFile, errFile])
+    tail.stdout.pipe(process.stdout)
+    tail.stderr.pipe(process.stderr)
+
+    process.on('SIGINT', () => {
+      tail.kill()
+      process.exit(0)
+    })
+
+    await new Promise(() => {}) // Wait forever
+  } else {
+    // Show last 50 lines
+    if (existsSync(logFile)) {
+      console.log('=== stdout.log ===')
+      const stdout = readFileSync(logFile, 'utf-8').split('\n').slice(-50).join('\n')
+      console.log(stdout)
+    }
+
+    if (existsSync(errFile)) {
+      console.log('\n=== stderr.log ===')
+      const stderr = readFileSync(errFile, 'utf-8').split('\n').slice(-50).join('\n')
+      console.log(stderr)
+    }
+  }
+}
+
+async function installDaemon() {
+  ensureDirs()
+
+  const plist = generatePlist()
+  writeFileSync(PLIST_PATH, plist)
+  console.log(`Installed plist to ${PLIST_PATH}`)
+
+  // Load the daemon
+  execSync(`launchctl load ${PLIST_PATH}`)
+  console.log('Daemon loaded and started.')
+  console.log(`Server will start automatically on login.`)
+  console.log(`\nTo uninstall: wtb-server uninstall`)
+}
+
+async function uninstallDaemon() {
+  if (isLaunchctlLoaded()) {
+    execSync(`launchctl unload ${PLIST_PATH}`)
+    console.log('Daemon unloaded.')
+  }
+
+  if (existsSync(PLIST_PATH)) {
+    unlinkSync(PLIST_PATH)
+    console.log(`Removed ${PLIST_PATH}`)
+  }
+
+  console.log('Daemon uninstalled.')
+}
+
+function showHelp() {
+  console.log(`
+Walkie Talkie Bot Server CLI
+
+Usage: wtb-server <command> [options]
+
+Commands:
+  start [-f]      Start the server (use -f for foreground)
+  stop            Stop the server
+  restart         Restart the server
+  status          Show server status
+  logs [-f]       Show logs (use -f to follow)
+  install         Install as launchd daemon (auto-start on login)
+  uninstall       Remove launchd daemon
+
+Environment:
+  WTB_PORT    Server port (default: 5173)
+`)
+}
+
+// Import createWriteStream for logging
+import { createWriteStream } from 'fs'
+
+commands().catch(console.error)

package/bin/wtb.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+
+import { startServer } from '../server/index.js'
+import open from 'open'
+
+const PORT = parseInt(process.env.WTB_PORT || '5173', 10)
+const URL = `https://localhost:${PORT}`
+
+async function main() {
+  console.log('Starting Walkie Talkie Bot...')
+
+  try {
+    await startServer(PORT)
+
+    // Open browser after server starts (prefer Chrome for Web Speech API support)
+    console.log(`Opening ${URL}...`)
+    console.log('(Requires Chrome/Edge - Firefox does not support Web Speech API)')
+
+    // Try to open in Chrome, fall back to default browser
+    try {
+      await open(URL, { app: { name: 'google chrome' } })
+    } catch {
+      await open(URL)
+    }
+
+    console.log('\nWalkie Talkie Bot is running. Press Ctrl+C to stop.')
+  } catch (err) {
+    if (err instanceof Error && err.message.includes('already in use')) {
+      console.log(`Walkie Talkie Bot appears to already be running on port ${PORT}`)
+      console.log(`Opening ${URL}...`)
+      try {
+        await open(URL, { app: { name: 'google chrome' } })
+      } catch {
+        await open(URL)
+      }
+    } else {
+      console.error('Failed to start Walkie Talkie Bot:', err)
+      process.exit(1)
+    }
+  }
+}
+
+main()