> ## Documentation Index
> Fetch the complete documentation index at: https://docs.parsaa.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Solutions for common Parsaa issues

## Common Issues

<AccordionGroup>
  <Accordion title="Accessibility Permissions">
    **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

    <Warning>
      Parsaa requires Accessibility permissions to observe your Xcode session. Without this, most features will not work.
    </Warning>
  </Accordion>

  <Accordion title="Xcode Not Detected">
    **Problem:** Parsaa does not see your open Xcode project.

    **Solution:**

    1. Make sure Xcode is open with a workspace or project loaded
    2. Check that Accessibility permissions are granted (see above)
    3. Restart Parsaa

    <Info>
      Parsaa detects Xcode through macOS Accessibility APIs. It needs an active workspace or project — opening a single file is not enough.
    </Info>
  </Accordion>

  <Accordion title="AI Response Failures">
    **Problem:** Messages fail or return errors.

    **Solution:**

    1. Check your internet connection
    2. If you use BYOK, verify your API keys are valid
    3. Check if you have remaining credits (Settings → Account → Billing & Usage)
    4. Try switching to a different model
    5. Check the AI provider's status page for outages:
       * [OpenAI Status](https://status.openai.com)
       * [Anthropic Status](https://status.anthropic.com)
       * [Google Cloud Status](https://status.cloud.google.com)

    <Tip>
      If one provider is experiencing issues, switch to a different model from another provider to continue working.
    </Tip>
  </Accordion>

  <Accordion title="Slow Responses">
    **Problem:** AI takes a long time to respond.

    **Solution:**

    * Frontier models and higher reasoning effort take longer. Try a faster model or a lower reasoning effort
    * 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
  </Accordion>

  <Accordion title="Local Model Connection Issues">
    **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

    <Info>
      See the [Local Models guide](/providers/local-models) for detailed setup instructions.
    </Info>
  </Accordion>

  <Accordion title="Semantic Search Not Working">
    **Problem:** The agent isn't finding relevant code by meaning.

    **Solution:**

    1. Enable **Code Indexing** for the project in **Settings → Project → Code Indexing**
    2. Wait for the initial index to finish — the progress pill shows status
    3. Check that your project has source files to index
    4. Re-run indexing from the Code Indexing settings if needed
  </Accordion>
</AccordionGroup>

## Still Need Help?

<Card title="Contact Support" icon="envelope" href="mailto:hello@parsaa.app">
  Email us at [hello@parsaa.app](mailto:hello@parsaa.app) and we will get back to you as soon as possible.
</Card>