Cursor

Cursor is an IDE designed specifically to work with AI agents.

Install

brew install --cask cursor

Configure

Themes

To detect the system settings for light/dark mode, open the JSON settings and include these lines:

{
  "window.autoDetectColorScheme": true,
  "workbench.preferredLightColorTheme": "Visual Studio Light",
  "workbench.preferredDarkColorTheme": "Visual Studio Dark"
}

Rules

Add Cursor Rules with your preferences to guide the coding agent.

For example, if the agent is referencing old training data about Poetry, you can correct it. (This rule is written using XML syntax.)

<poetry>
- Do not suggest `poetry lock --no-update`. It is outdated. Suggest `poetry lock` instead.
</poetry>

MCP servers

GitHub

Install the GitHub MCP server.

Create a PAT (see GitHub) with the public repo access and no additional permissions. This ensures your token has the least amount of privilege.

  • Repository access: Public repositories

Edit the MCP configuration, e.g., mcp.json, to include the read-only header, reducing the amount of tools the agent can access. (Too many tools overwhelms Cursor.)

// ...
    "github": {
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer ${YOUR_GITHUB_PAT}",
        "X-MCP-Readonly": "true"
      }
    }
// ...

Website documentation

Cursor can crawl any website added as a custom doc.

Cursor
Interactive graph
On this page
Install
Configure
Themes
Rules
MCP servers
GitHub
Website documentation