Cursor Rules for Building Agents

A .cursorrules file supplies legacy Cursor instructions for building Agno agents. Other editors need their own rule-file format.

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

These instructions help an assistant:

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

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

Cursor reads this legacy file. For new projects, place maintained instructions in .cursor/rules/*.mdc using Cursor's project-rule format.

IDE Support

• Cursor: .cursorrules is legacy; prefer Project Rules.
• Windsurf / Cascade: adapt the instructions to its own rules format. Current Cascade rules use .devin/rules/*.md, with legacy .windsurf/rules/*.md and .windsurfrules support. Repository AGENTS.md is also supported. Configure the rule's activation mode; copying a Cursor filename is insufficient.
• Other assistants: follow the assistant's documented instruction-file format.

Learn More

For detailed examples and patterns: