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

# Quick Start

> Get up and running with Parsaa in under 5 minutes

Get up and running with Parsaa in minutes. This guide walks you through your first session.

## Your First Session

<Steps>
  <Step title="Install Parsaa">
    Download Parsaa from [parsaa.app](https://parsaa.app) and follow the [installation guide](/installation).
  </Step>

  <Step title="Open your project in Xcode">
    Open any Swift project in Xcode. Parsaa detects the active workspace automatically.
  </Step>

  <Step title="Pick the project in Parsaa">
    On the Welcome screen, select the detected project (or pick a folder). Parsaa loads it with full context.
  </Step>

  <Step title="Start chatting">
    Ask a question about your code. Parsaa sees your open files, project structure, and build errors — no copy-pasting needed.
  </Step>
</Steps>

## Try These Workflows

<Tabs>
  <Tab title="Chat">
    Ask **"Explain the architecture of this project"** or **"How does the networking layer work?"**

    Parsaa reads the relevant files and answers in context, using its built-in tools to navigate your codebase.
  </Tab>

  <Tab title="Commands & Generators">
    On the focused Xcode file, type `/` for a command or `@` for a generator:

    * `/modernize` — modernize deprecated Apple APIs
    * `/analyze` — detect deprecated Apple APIs (free, read-only)
    * `@tester` — generate unit tests for the focused file
    * `@documenter` — generate doc comments for the focused file

    See [Slash Commands](/features/slash-commands).
  </Tab>

  <Tab title="Capture Code">
    Select code in Xcode and trigger the **Capture Code** shortcut to pull the selection into Parsaa as a context chip. Bind the shortcut in **Settings → Preferences → Shortcuts**.
  </Tab>

  <Tab title="Plan Mode">
    Ask for a complex change like **"Refactor the networking layer to use async/await."**

    Parsaa proposes a step-by-step plan and waits for your approval before executing. You stay in control the entire time.
  </Tab>
</Tabs>

## Built-in Tools

During a conversation, Parsaa's agent autonomously calls tools to work in your project. You don't invoke them manually — the agent picks the right tool for each step. A few examples by category:

| Category        | Tools                                                                                                         |
| --------------- | ------------------------------------------------------------------------------------------------------------- |
| Read & navigate | `file_tree`, `read_files`, `grep_project`, `globs`, `search_file_names`, `get_symbol_info`, `semantic_search` |
| Edit            | `create_file`, `edit_file`, `rewrite_file`, `delete_file`, `apply_code`                                       |
| Build & run     | `compile_app`, `run_app`, `test_app`, `stop_app`, `list_schemes`, `list_simulators`                           |
| Plan & extend   | `plan_create`, `todo_write`, `skill`, `mcp_tool`, `web_search`                                                |

<Tip>
  You can enable, disable, and set per-tool permissions in **Settings → Extensions → Tools**.
</Tip>

## Next Steps

<CardGroup cols={2}>
  <Card title="Chat with Code" icon="comments" href="/features/chat-with-code">
    Learn how Parsaa works alongside Xcode.
  </Card>

  <Card title="AI Providers" icon="key" href="/providers/api-keys">
    Configure API keys and choose your models.
  </Card>

  <Card title="Plan Mode" icon="list-check" href="/features/plan-mode">
    Let Parsaa plan and execute complex multi-file changes.
  </Card>

  <Card title="Quick Reference" icon="keyboard" href="/configuration/cheatsheet">
    Shortcuts, slash commands, and the tool list.
  </Card>
</CardGroup>