> ## 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.

# Installation

> Download and set up Parsaa for AI-powered Xcode development

## System Requirements

<CardGroup cols={2}>
  <Card title="macOS" icon="apple">
    macOS 26.2 (Tahoe) or later
  </Card>

  <Card title="Processor" icon="microchip">
    Apple Silicon (M1 or later)
  </Card>

  <Card title="Xcode" icon="hammer">
    Xcode installed (Xcode 26.3+ for the native Xcode MCP integration)
  </Card>

  <Card title="Internet" icon="wifi">
    Active internet connection (except when using a Local provider)
  </Card>
</CardGroup>

## Installation

<Steps>
  <Step title="Download Parsaa">
    Download the latest version from [parsaa.app](https://updates.parsaa.app/releases/Parsaa.dmg).
  </Step>

  <Step title="Install">
    Open the downloaded DMG and drag Parsaa to your **Applications** folder.
  </Step>

  <Step title="Launch">
    Open Parsaa from your Applications folder.
  </Step>

  <Step title="Grant Accessibility Permissions">
    macOS will prompt you to grant Accessibility permissions. Parsaa uses the macOS Accessibility API to read your Xcode workspace and capture the current selection.

    Go to **System Settings > Privacy & Security > Accessibility** and enable Parsaa.

    <Warning>
      Parsaa needs Accessibility permissions to read your Xcode workspace. Without them, project detection and Capture Code will not work.
    </Warning>
  </Step>

  <Step title="Sign In">
    Create your account or sign in. Sign-in supports email and Google.
  </Step>
</Steps>

## First Launch Setup

After signing in, complete your initial setup:

<AccordionGroup>
  <Accordion title="Choose Your Plan">
    Parsaa offers **Free**, **Pro**, **Lite**, and **Elite** tiers. Each tier includes different monthly credits, reasoning levels, and features. See [parsaa.app](https://parsaa.app) for current pricing.
  </Accordion>

  <Accordion title="Configure Your AI Provider">
    Use the included credits to start immediately, or bring your own keys for OpenAI, Anthropic, Google Gemini, OpenRouter, or a Local endpoint. See [API Keys](/providers/api-keys).
  </Accordion>

  <Accordion title="Pick a Project">
    On the Welcome screen, Parsaa detects open Xcode projects and lists recent ones. Choose a project — or select a folder manually — to start a conversation with full project context.
  </Accordion>
</AccordionGroup>

## Automatic Updates

<Info>
  Parsaa checks for updates automatically (Settings → Preferences → Updates). You'll be notified when new versions are available and can install them with a single click.
</Info>

## Uninstallation

<Steps>
  <Step title="Quit Parsaa">
    Make sure Parsaa is fully quit before proceeding.
  </Step>

  <Step title="Remove the App">
    Drag Parsaa from your **Applications** folder to the Trash.
  </Step>

  <Step title="Remove Application Data (Optional)">
    To remove all Parsaa data, delete:

    ```
    ~/Library/Application Support/Parsaa/
    ```
  </Step>

  <Step title="Revoke Accessibility Permissions">
    Go to **System Settings > Privacy & Security > Accessibility** and remove Parsaa from the list.
  </Step>
</Steps>