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

# Agents

> AI agents specialized for development tasks

Alex Sidebar's agents are specialized AI assistants, each trained for specific development tasks. Alex automatically selects the right agent for your workflow for autonomously handling your development tasks!

<Note>
  Agent mode is now always on! Claude Sonnet 4 is the recommended model for its superior code generation capabilities, but you can now use other supported models including:

  * Claude 3.5 Sonnet
  * Gemini 2.5 Pro
  * Gemini 2.5 Flash
  * OpenAI o3
  * OpenAI o4 Mini
  * OpenAI GPT 4.1
  * DeepSeek R1
  * DeepSeek V3 (03.24)

  Choose your preferred model from the model selector while maintaining all agent capabilities.
</Note>

## Quick Actions

<CardGroup cols={2}>
  <Card title="Build & Fix Errors" icon="hammer">
    One-click automatic build, error detection, and fix application. Alex continuously rebuilds until your project compiles successfully.
  </Card>

  <Card title="Smart Automation" icon="wand-magic-sparkles">
    Let agents handle repetitive tasks while you focus on core development work.
  </Card>

  <Card title="Multi-Model Support" icon="robot">
    Switch between different AI models while maintaining agent capabilities and context.
  </Card>
</CardGroup>

## Understanding Agents

Agents work best by:

* Learning your project structure and patterns
* Maintaining contextual understanding across sessions
* **Automatically building and running your app after changes**
* **Detecting and fixing compilation errors in a continuous loop**
* **Taking screenshots for verification and debugging**

<Note>
  You can make agents more effective over time by providing more notes about your project and coding preferences. Learn more about project notes [here](/chat/context/memory).
</Note>

## Getting Started

<Steps>
  <Step title="Toggle Auto-Apply">
    Press **Command + Shift + A** to toggle auto-apply for code changes. When enabled, code suggestions will be automatically applied to your files.
  </Step>

  <Step title="Project Introduction">
    Use voice or text to describe your project:

    ```swift theme={null}
    "This is an iOS app using SwiftUI and MVVM architecture. 
    The main features include user authentication and data persistence."
    ```
  </Step>

  <Step title="Let Agent Learn">
    The agent will:

    * Analyze project structure
    * Study coding patterns
    * Build contextual understanding
    * Use regex search to find relevant code patterns
  </Step>
</Steps>

## Automatic Build & Run

<Note>
  Alex Sidebar's agent automatically builds and runs your project after making changes, creating a seamless development experience.
</Note>

<Warning>
  While the agent handles most errors automatically, always review the final changes to ensure they align with your project's requirements.
</Warning>

## Best Practices

<CardGroup cols={2}>
  <Card title="Clear Communication" icon="message">
    Provide specific requirements and context for best results
  </Card>

  <Card title="Iterative Development" icon="rotate">
    Break complex tasks into smaller, manageable steps
  </Card>

  <Card title="Review Changes" icon="code-pull-request">
    Always review and test agent-suggested modifications
  </Card>

  <Card title="Maintain Context" icon="brain-circuit">
    Keep project notes updated for better agent performance
  </Card>
</CardGroup>