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

# Cursor AI

> Getting started with Cursor.

<iframe width="100%" height="400" src="https://www.youtube.com/embed/Og73plUTabs" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen style={{ borderRadius: "10px" }} />

## Why Use Cursor

Cursor simplifies AI agent development by reducing the feedback loop on AI-generated code. This enables faster iteration and provides an optimal balance between manual control and AI assistance.

<img src="https://mintcdn.com/vrsenai/T-GvwUlkVZr46TES/images/cursor-overview.png?fit=max&auto=format&n=T-GvwUlkVZr46TES&q=85&s=fefa643ee4bff3332b4d6cdd55d91d5c" alt="Cursor IDE Overview" width="1930" height="1070" data-path="images/cursor-overview.png" />

## What are Cursor Rules

**Cursor Rules** are custom instructions that tell Cursor how to work with your code. Agency has a predefined `.cursorrules` file that contains everything that Cursor needs to know in order to create agents with this framework.

<img src="https://mintcdn.com/vrsenai/T-GvwUlkVZr46TES/images/cursor-rules-example.png?fit=max&auto=format&n=T-GvwUlkVZr46TES&q=85&s=1ed64157ac48d5d428eeb953fa2098f4" alt="Cursor Rules Example" width="1756" height="626" data-path="images/cursor-rules-example.png" />

## Getting Started with Cursor

Follow these steps to create your first Agency using Cursor:

<Tip>
  Prefer a ready-to-run repo? Start from the [Starter Template](/welcome/getting-started/starter-template).
</Tip>

<Steps>
  <Step title="Enable Cursor Rules in Settings">
    First, you need to enable Cursor Rules in the Cursor IDE:

    * Open the Cursor IDE.
    * Go to **Settings...** > **Cursor Settings**.

    <img src="https://mintcdn.com/vrsenai/T-GvwUlkVZr46TES/images/open-cursor-settings.png?fit=max&auto=format&n=T-GvwUlkVZr46TES&q=85&s=a17083282492ea45c07a6890eabd9b87" width="65%" alt="Open Cursor Settings" style={{display: 'block', margin: '0 auto'}} data-path="images/open-cursor-settings.png" />

    * Turn on the **Rules for AI** option. This allows you to use a `.cursorrules` file in your project.
          <img src="https://mintcdn.com/vrsenai/T-GvwUlkVZr46TES/images/enable-cursor-rules.png?fit=max&auto=format&n=T-GvwUlkVZr46TES&q=85&s=854680169020b7b4dd50021cbf4e4178" alt="Enable Cursor Rules" width="1957" height="481" data-path="images/enable-cursor-rules.png" />
  </Step>

  <Step title="Add The `.cursorrules` File to Your Project">
    The `.cursorrules` file contains the instructions that guide Cursor's AI. To add it:

    * Download the `.cursorrules` file from the [Agency Swarm repository](https://github.com/VRSEN/agency-swarm/blob/main/.cursorrules).
    * Place the file in the main folder (root directory) of your project.
  </Step>

  <Step title="Open Cursor Composer">
    Cursor Composer allows you to create and modify multiple files in parallel.

    * Open Composer by pressing `Cmd+I` (macOS) or `Ctrl+I` (Windows/Linux).
  </Step>

  <Step title="Send Your First Prompt to Composer">
    Spend as much time as possible on your first prompt. This will save you a lot of time later. Make sure to include:

    * All agents that you want to create
    * All tools and APIs that the agents must use
    * Communication flows between your agents
  </Step>

  <Step title="Verify The Agency Structure">
    Sometimes Cursor forgets certain files or hallucinates the agency structure. Make sure to verify that:

    * All import statements are correct
    * `requirements.txt` file exists
    * `agency.py` file executes properly

    If any of these are missing or not working, instruct composer to create them or fix the code.
  </Step>

  <Step title="Adjust the Tools">
    Run each tool file to make sure they work as expected. You will see the test cases that Cursor created at the bottom in `if __name__ == "__main__"` statements.

    * If any of the tools are not working, send the error message to composer and ask it to fix the code.
    * If you want to adjust the functionality of the tool, either use inline editing `Cmd+K` (macOS) or `Ctrl+K` (Windows/Linux) or send another message to composer.
    * If you are stuck, use Chat `Cmd+L` (macOS) or `Ctrl+L` (Windows/Linux) to ask questions and brainstorm alternative approaches. For example, ask "What other APIs can I use for this tool?"
  </Step>

  <Step title="Adjust the Agents">
    Verify the agent instructions and parameters are correct after adjustments. **Actually think about instructions.**

    * Use Chat or Inline Editing to adjust the `instruction.md` files to your needs.
    * Edit instructions manually and remove all boilerplate text.
    * Make sure each agent has access to all the new tools either by specifying `tools_folder` path or adding them in `tools` parameter.
  </Step>

  <Step title="Test Your Agency">
    Run `agency.py` file to see if it works.

    * Send a realistic task to your agency and see if it can complete it.
    * If it doesn't work as expected, try to send additional messages with more details and see if it helps.
    * Use these extra messages to guide yourself on how to adjust the instructions, so it can complete it next time.
  </Step>

  <Step title="Repeat">
    Iterate on your agency by repeating the process until you are satisfied with the results.

    <Note>
      **Agent Development is an Iterative Process**

      Currently, agent development requires ongoing monitoring and adjustments to ensure desired performance. As larger and more advanced models become available, this process will become more streamlined.
    </Note>
  </Step>
</Steps>

## Next Steps

* Learn the core concepts: [Tools Overview](/core-framework/tools/overview), [Agents Overview](/core-framework/agents/overview), and [Agencies Overview](/core-framework/agencies/overview).
* Run your first end-to-end flow with [Running an Agency](/core-framework/agencies/running-agency).