> ## Documentation Index
> Fetch the complete documentation index at: https://agno-v2.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://cursor.com/docs/context/rules) file teaches AI coding assistants (like Cursor, Windsurf) how to build better agents with Agno.

> [!NOTE]
>
> Cursor's primary rules format is now [Project Rules](https://cursor.com/docs/context/rules) (`.cursor/rules/*.mdc`).

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

It gives your AI assistant a reference for building 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.

> **[View .cursorrules on GitHub](https://github.com/agno-agi/agno/blob/main/.cursorrules)**
>
> View the full .cursorrules file for building agents with Agno

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

> **[Agent Examples](https://agno-v2.mintlify.site/examples/agents/overview.md)**
>
> See complete agent examples

> **[Agent Concepts](https://agno-v2.mintlify.site/agents/overview.md)**
>
> Learn agent fundamentals

> **[Teams](https://agno-v2.mintlify.site/teams/overview.md)**
>
> Multi-agent coordination

> **[Workflows](https://agno-v2.mintlify.site/workflows/overview.md)**
>
> Deterministic agent orchestration

> [!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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.