twinmind-common-errors

# TwinMind Common Errors ## Overview Quick reference for the most common TwinMind errors and their solutions. ## Prerequisites - TwinMind extension or API configured - Access to error logs or console - API credentials for testing ## Instructions ### Step 1: Identify the Error Check error message in console, extension popup, or API response. ### Step 2: Find Matching Error Below Match your error to one of the documented cases. ### Step 3: Apply Solution Follow the solution steps for your specific error. ## Error Reference ### Authentication Failed **Error Message:** ``` Error: Authentication failed - Invalid or expired API key Status: 401 Unauthorized # HTTP 401 Unauthorized ``` **Cause:** API key is missing, expired, or incorrect. **Solution:** ```bash set -euo pipefail # Verify API key is set correctly echo $TWINMIND_API_KEY # Test authentication curl -H "Authorization: Bearer $TWINMIND_API_KEY" \ https://api.twinmind.com/v1/health # Regenerate key if expired # Visit: https://twinmind.com/settings/api ``` --- ### Microphone Access Denied **Error Message:** ``` Error: Microphone permission denied NotAllowedError: Permission denied ``` **Cause:** Browser or OS hasn't granted microphone access. **Solution:** Chrome: ``` 1. Click lock icon in address bar 2. Site Settings > Microphone > Allow 3. Reload the page ``` macOS: ```bash # Check current permissions tccutil list com.google.Chrome # Reset permissions (requires re-grant) tccutil reset Microphone com.go...