⚡ Quick Summary
  • Agency Agents installs as .mdc rule files in your .cursor/rules/ directory.
  • Use the desktop app for the easiest path — it handles format conversion automatically.
  • Or use the CLI: ./scripts/install-cursor.sh from the cloned repo.

How to Install Agency Agents in Cursor (2026)

📅 Updated July 2026⏱️ 5 min read🛠️ Difficulty: Easy

How Cursor Handles Agency Agents

Unlike Claude Code which uses Markdown files in ~/.claude/agents/, Cursor uses .mdc rule files stored in your project's .cursor/rules/ directory.

The Agency Agents desktop app and install scripts handle this conversion automatically — you pick the agents, they get rendered into the correct format for Cursor.

Method A: Desktop App (Recommended)

1
Download the Agency Agents desktop app

Download from agencyagents.app — available for macOS, Windows, and Linux.

2
Select Cursor as your target tool

In the Tools Panel, find Cursor and confirm it's detected. Set your project directory as the target.

3
Browse and select agents

Browse the catalog by division. Select individual agents or a preset team.

4
Click Deploy

The app generates .mdc files in your .cursor/rules/ directory automatically.

Method B: CLI Install Script

# Clone the repo
git clone https://github.com/msitarzewski/agency-agents
cd agency-agents

# Run the Cursor install script
./scripts/install-cursor.sh

# Verify: check your .cursor/rules/ directory
ls .cursor/rules/

FAQ

Where does Agency Agents install files in Cursor?

Agency Agents generates .mdc rule files and places them in the .cursor/rules/ directory in your project root. These are picked up automatically by Cursor when you open the project.

Do I need the desktop app to install in Cursor?

The desktop app (agencyagents.app) is the easiest approach as it handles the .mdc format conversion automatically. The manual CLI method using the install-cursor.sh script also works.

Can I use Agency Agents in Cursor's agent mode?

Yes. In Cursor's agent mode, the installed rules are automatically applied to the agent's behavior. You can also reference specific agent personas by name in your chat prompts.