TameAGENTS provides first-class support for Cursor AI rules files, enabling seamless integration between your AGENTS.md files and Cursor's AI assistant.

Supported Files

Legacy Format

TameAGENTS detects .cursorrules files in your repository root. This is the legacy Cursor rules format.

# .cursorrules
# Your Cursor AI rules
- Rule 1
- Rule 2

Current Format

The current Cursor format uses .cursor/rules/*.md files. TameAGENTS scans this directory and detects all Markdown files as separate rule sets.

.cursor/
└── rules/
    ├── base.md
    ├── backend.md
    └── frontend.md

Detection & Parsing

When TameAGENTS detects Cursor rules files, it:

Extracts the first heading as the summary
Identifies tags and keywords from the content
Assumes repo-wide application (best-effort for globs)
Assigns precedence (0 = strongest for .cursorrules, 1 for .cursor/rules/*.md)

Commands

TameAGENTS: Open Cursor Rules

Opens detected Cursor rules files. If multiple files are detected, shows a quick pick menu.

TameAGENTS: Generate Cursor Rules from AGENTS.md

Converts your AGENTS.md file to Cursor rules format. Creates a new file in .cursor/rules/ with a diff preview before writing.

Conversion from AGENTS.md

When you run "Generate Cursor Rules from AGENTS.md", TameAGENTS:

Parses your AGENTS.md file to extract rules, owners, and tags
Converts them to Cursor-compatible Markdown format
Shows a preview before creating the file
Writes to .cursor/rules/AGENTS-<folder>.md

Caveats & Limitations

Glob patterns: TameAGENTS makes best-effort attempts to infer where rules apply, but Cursor's internal scoping may differ
Precedence: When multiple rule files exist, TameAGENTS respects file order but cannot guarantee Cursor's internal precedence logic
Sync: Changes to Cursor rules are not automatically reflected in AGENTS.md (unidirectional conversion)

Configuration

Enable or disable Cursor provider in VS Code settings:

{
  "tameagents.providers.cursor.enabled": true
}

Example

See the examples/sample-repo directory for a complete example with .cursorrules and .cursor/rules/*.md files.

Cursor Integration