Skip to main content

​
Common Issues and Solutions

​
Chat and Response Issues

Symptoms: - No responses in chat - Server timeouts - “Error connecting to LLM API” - Rainbow wheel appearing - Infinite spinners Solutions: 1. Check API Connection: - Verify internet connection - If using custom API key, ensure it’s valid - Check your API key balance and rate limits 2. If App Freezes: - Force quit Alex Sidebar - Restart Xcode - Clear chat history 3. For Server Timeouts: - Reduce context size - Break large requests into smaller ones - Check if you’re exceeding context limits

​
Project Indexing and File Issues

Symptoms:
  • Stuck on indexing
  • Files not being created properly
  • Wrong file modifications
  • Issues with multiple Xcode projects
Solutions:
  1. For Indexing Problems:
  • Restart Alex Sidebar
  • Clear Xcode’s derived data
  • Check project permissions
  1. File Creation Issues:
  • Use menu options instead of + button
  • Verify write permissions
  • Check for path existence
  1. Multiple Projects:
  • Keep only one project active when possible
  • Verify correct project selection
  • Double-check file paths before modifications

​
UI and Window Management

Symptoms:
  • Incorrect window resizing
  • Text truncation
  • Sidebar growing to full screen
  • Font size issues
Solutions:
  1. Window Issues:
  • Use Cmd+ and Cmd- for font scaling
  • Restart app if window becomes unresponsive
  • Maintain minimum window width
  1. Display Problems:
  • Toggle fullscreen mode
  • Reset window position
  • Check display scaling settings

​
Performance Optimization

​
Model Selection and API Usage

Best Practices for API Usage:
  • Use appropriate models for different tasks:
    • GPT-4 for complex code generation
    • Claude for documentation and explanations
    • GPT-3.5 for quick queries
  • When using custom API keys:
    • Verify correct model selection
    • Monitor credit usage
    • Check for rate limits

​
Keyboard and Input

Current Issues:
  • Escape key capture affecting Vim users
  • Dvorak keyboard layout conflicts
  • Some shortcuts may conflict with Xcode
Workarounds:
  • Use menu options instead of shortcuts
  • Check for keyboard shortcut conflicts in System Preferences
  • Wait for upcoming customizable shortcuts feature
Known Issues:
  • Crashes when pasting in input field
  • Text loss in prompt inputs
  • Duplicate text in inputs
Temporary Solutions:
  • Type text manually instead of pasting
  • Break large pastes into smaller chunks
  • Save important prompts externally

​
Reporting New Issues

If you encounter issues not covered here:
  1. Check the version number
  2. Document the steps to reproduce
  3. Capture relevant screenshots/recordings
  4. Report through appropriate channels:
    • Discord for quick help
    • GitHub for bug tracking
    • Email for account/license issues
For fastest resolution: - Include your system information - Provide clear reproduction steps - Mention any recent changes or updates - Include relevant error messages
⌘I