Skip to main content

​
Common Issues

Problem: Parsaa cannot detect Xcode or interact with it.Solution:
  1. Open System Settings > Privacy & Security > Accessibility
  2. Make sure Parsaa is listed and the toggle is enabled
  3. If Parsaa is not listed, click the + button and add it manually
  4. If it is listed but not working, remove it and re-add it
  5. Restart Parsaa after making changes
Parsaa requires Accessibility permissions to observe your Xcode session. Without this, most features will not work.
Problem: Parsaa does not see your open Xcode project.Solution:
  1. Make sure Xcode is open with a workspace or project loaded
  2. Verify you are running a supported Xcode version (16.0+)
  3. Check that Accessibility permissions are granted (see above)
  4. Restart Parsaa
Parsaa detects Xcode through macOS Accessibility APIs. It needs an active workspace or project — opening a single file is not enough.
Problem: Messages fail or return errors.Solution:
  1. Check your internet connection
  2. Verify your API keys are valid (Lite plan users)
  3. Check if you have remaining credits (Pro/Elite plan users)
  4. Try switching to a different model
  5. Check the AI provider’s status page for outages:
If one provider is experiencing issues, switch to a different model from another provider to continue working.
Problem: AI takes a long time to respond.Solution:
  • Larger models (Opus, o3-pro) naturally take longer to respond. Try a faster model like GPT-5 Mini or Gemini 2.5 Flash
  • Check your internet connection speed
  • For local models, ensure your Mac has sufficient RAM for the model size
  • Large project contexts increase response time — try being more specific in your request
Problem: Cannot connect to Ollama or LM Studio.Solution:
  1. Verify Ollama or LM Studio is running on your Mac
  2. Check the local server is accessible:
    • Ollama default: localhost:11434
    • LM Studio default: localhost:1234
  3. Ensure you have pulled/downloaded at least one model
  4. Verify Parsaa’s endpoint configuration matches the server address
See the Local Models guide for detailed setup instructions.
Problem: Semantic Search returns no results.Solution:
  1. Verify your VoyageAI API key is configured in API Keys
  2. Wait for initial indexing to complete — the first time you use Semantic Search on a project, Parsaa needs to generate embeddings for your codebase
  3. Check that your project has Swift files to index
  4. Try rebuilding the index from Parsaa’s settings

​
Still Need Help?

Contact Support

Email us at [email protected] and we will get back to you as soon as possible.