Mohamed Boudra
bf58e81ce8
Replace subscription-based session accessor pattern with direct snapshot updates in daemon connections context. Add sessionReady flag to connection state to track when initial agent list has been received. Auto-select first ready host in create agent modal. Migrate from app.json to app.config.js. Add android:release script and Playwright testing docs.
1.6 KiB
CLAUDE.md
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
Project Overview
Voice-controlled terminal assistant using OpenAI's Realtime API (via Whisper STT, GPT-4, and TTS). Backend server with Expo app for all platforms (iOS, Android, and Web).
Monorepo Structure
This is an npm workspace monorepo:
- Root: Workspace configuration and shared TypeScript config
- packages/server: Backend server (Express + WebSocket API)
- packages/app: Cross-platform app (Expo - iOS, Android, Web)
Running and checking logs
We run the mobile app and server in the tmux session voice-dev:
tmux capture-pane -t voice-dev:mobile -p
tmux capture-pane -t voice-dev:server -p
Don't run them anywhere else. Check logs there.
Android
Take screenshots like this: adb exec-out screencap -p > screenshot.png
Testing with Playwright MCP
Use the Playwright MCP to test the app in Metro web. Navigate to http://localhost:8081 to interact with the app UI.
Important: Do NOT use browser history (back/forward). Always navigate by clicking UI elements or using browser_navigate with the full URL. The app uses client-side routing and browser history navigation breaks the state.
Expo troubleshooting
Run npx expo-doctor to diagnose version mismatches and native module issues.
Asking Codex for a second opinion
You can ask Codex for a second opinion on a problem you're working on.
Set a high timeout, like 2 minutes.
Try not to bias it, state the problem clearly and let it work it out.
codex exec "prompt"
CRITICAL: ALWAYS RUN TYPECHECK AFTER EVERY CHANGE.