​
Common Issues and Solutions

​
Chat and Response Issues

​
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

​
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