> ## Documentation Index
> Fetch the complete documentation index at: https://phidatainc-studio-tools-doc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor Rules for Building Agents

> Use .cursorrules to improve AI coding assistant suggestions when building agents with Agno

A [`.cursorrules`](https://docs.cursor.com/context/rules-for-ai) file teaches AI coding assistants (like Cursor, Windsurf) how to build better agents with Agno.

## What is .cursorrules?

`.cursorrules` is a configuration file that provides your AI coding assistant with instructions on how to generate specific code.
Agno's recommended `.cursorrules` file contains:

* Agno-specific patterns and best practices
* Correct parameter names and syntax
* Common mistakes to avoid
* When to use Agent vs Team vs Workflow

Think of it as a reference guide that helps your AI assistant build agents correctly with Agno.

## Why Use It?

Without `.cursorrules`, AI assistants might suggest:

* Wrong parameter names (like `agents=` instead of `members=` for Teams)
* Outdated patterns or incorrect syntax
* Performance anti-patterns (creating agents in loops)
* Non-existent methods or features

With `.cursorrules`, your AI will:

* Suggest correct Agno patterns automatically
* Follow performance best practices
* Use the right approach for your use case
* Catch common mistakes before you make them

## How to Use .cursorrules

Copy the Agno `.cursorrules` file to your project root:

```bash theme={null}
# Download the .cursorrules file
curl -o .cursorrules https://raw.githubusercontent.com/agno-agi/agno/main/.cursorrules

# Or clone and copy
git clone https://github.com/agno-agi/agno.git
cp agno/.cursorrules /path/to/your/project/
```

Your AI assistant (Cursor, Windsurf, etc.) will automatically detect and use it.

<Card title="View .cursorrules on GitHub" icon="github" href="https://github.com/agno-agi/agno/blob/main/.cursorrules">
  View the full .cursorrules file for building agents with Agno
</Card>

## IDE Support

`.cursorrules` works with:

* **Cursor** - Automatic detection
* **Windsurf** - Native support
* **Other AI assistants** - Support may vary depending on integration

## Learn More

For detailed examples and patterns:

<CardGroup cols={3}>
  <Card title="Agent Examples" icon="code" href="/cookbook/agents/overview">
    See complete agent examples
  </Card>

  <Card title="Agent Concepts" icon="book" href="/agents/overview">
    Learn agent fundamentals
  </Card>

  <Card title="Teams" icon="users" href="/teams/overview">
    Multi-agent coordination
  </Card>

  <Card title="Workflows" icon="workflow" href="/workflows/overview">
    Deterministic agent orchestration
  </Card>
</CardGroup>

<Note>
  The `.cursorrules` file is focused on **building agents with Agno**. If you're contributing to the Agno framework itself, that will be covered separately.
</Note>