Troubleshooting
Common issues and how to resolve them.
VS Code Extension Issues
Extension not showing in VS Code
Can't find ÆtherLight after installation.
Solutions:
- • Restart VS Code after installation
- • Check Extensions panel for "ÆtherLight"
- • Verify VS Code version is 1.80 or higher
- • Try reinstalling:
code --install-extension aetherlight.aetherlight
Voice activation not working
Pressing backtick (`) doesn't activate voice.
Solutions:
- • Check for conflicting keybindings in VS Code
- • Verify extension is enabled in Extensions panel
- • Try using Command Palette: "ÆtherLight: Activate Voice"
- • Check if another extension uses the backtick key
Sprint File Issues
TOML parse error
Sprint file has syntax errors.
Solutions:
- • Use a TOML validator to find the error
- • Check for unbalanced quotes or brackets
- • Ensure dates are in ISO format (YYYY-MM-DD)
- • Verify task IDs are unique within the sprint
Sprint not loading in web UI
Created a TOML file but it doesn't appear in the web interface.
Solutions:
- • Upload your TOML file through the web UI
- • Ensure the file follows the correct format
- • Check that you're signed into the correct account
- • Refresh the page after uploading
Web UI Issues
Can't sign in
Authentication fails or hangs.
Solutions:
- • Check internet connection
- • Clear browser cookies and try again
- • Try a different browser
- • Check if service is down on our status page
Task routing not working
Can't send tasks to terminal agents.
Solutions:
- • Make sure you've named your terminals (right-click to rename)
- • Verify the VS Code extension is connected
- • Check that the terminal is open in VS Code
- • Try reloading the web UI
Voice Transcription Issues
Voice not transcribing
Recording works but no text appears.
Solutions:
- • Check your internet connection (transcription requires server)
- • Verify you have remaining tokens in your account
- • Speak clearly and at normal volume
- • Check your microphone is working in system settings
Poor transcription quality
Text is transcribed but inaccurate.
Solutions:
- • Use a better microphone (headset recommended)
- • Reduce background noise
- • Speak technical terms slowly and clearly
- • Use common programming terms (Whisper is trained on them)
Still Having Issues?
If none of the above solutions work:
- 1Check the VS Code Output panel for ÆtherLight logs
- 2Search existing GitHub issues for similar problems
- 3Open a new issue with error logs and steps to reproduce