Skip to content
This repository was archived by the owner on Nov 18, 2025. It is now read-only.
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docs-sidebar.js
Original file line number Diff line number Diff line change
Expand Up @@ -320,6 +320,7 @@ const sidebars = {
'contributing/leadership/funding',
'contributing/leadership/triaging-issues',
'contributing/leadership/new-core-contributors-guide',
'contributing/leadership/cursor-ide',
],
},
],
Expand Down
71 changes: 71 additions & 0 deletions docs/contributing/leadership/cursor-ide.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,71 @@
# Cursor IDE

[Cursor](http://cursor.com) is an AI-powered code editor that helps you automate code changes, create pull requests, and enforce custom rules in your codebase. This guide will show you how to:

- Set up the GitHub MCP server for automated pull requests
- Use Cursor to fix issues and streamline your workflow
- Create and manage custom rules with the `.cursor/rules` directory

---

## Installing the GitHub MCP Server

The GitHub MCP (Model Code Platform) server allows Cursor to connect with your GitHub repositories. With the MCP server, you can automate code changes, manage pull requests, and streamline your development process.

To install the MCP server, use the one-click install option available [here](https://docs.cursor.com/tools).

---

## Automating GitHub Workflows with Cursor

Once the MCP server is running and connected to your repository, you can use Cursor's AI to automate code changes and pull requests.

### Example: Fixing an Issue and Creating a Pull Request

Follow these steps to fix a GitHub issue using Cursor:

1. **Find the Issue**
Copy the link to the GitHub issue you want to address.
2. **Ask Cursor to Fix the Issue**
In Cursor, paste the issue link and ask:
_"Fix this issue and create a pull request."_
3. **Review the Changes**
Cursor will:
- Analyze the issue
- Suggest code changes
- Commit the changes
- Create a pull request on GitHub
4. **Track Progress**
Cursor will keep you updated on the status and provide links to the pull request and related commits.

---

## Managing Custom Rules with the `.cursor/rules` Directory

Cursor supports custom rules to help your team follow code style, workflows, and best practices. You can store these rules in the `.cursor/rules/` directory.

### Directory Structure

Each rule is a Markdown (`.mdc`) file that describes guidelines or steps. These files can contain:

Check failure on line 49 in docs/contributing/leadership/cursor-ide.md

View check run for this annotation

GitHub Advanced Security / check-spelling

Unrecognized Spelling

[mdc](#security-tab) is not a recognized word. \(unrecognized-spelling\)

- **Code style guidelines** - formatting rules, naming conventions, and best practices
- **Workflow instructions** - how to handle specific types of changes or features
- **Testing requirements** - what tests to write and how to structure them
- **Documentation standards** - how to document code changes and features
- **Review criteria** - what to look for when reviewing pull requests

Learn more about cursor rules: [documentation](https://docs.cursor.com/context/rules).

### Adding or Editing Rules

1. Create or edit Markdown files in `.cursor/rules/`.
2. Write clear, actionable instructions.
3. Cursor will automatically apply these rules when making code changes or reviewing pull requests.

---

## Tips for Using Cursor

- Use rules to enforce team conventions, automate changelog creation, or standardize testing.
- You can ask Cursor to explain or follow any rule in your `.cursor/rules/` directory.
- Keep rules concise and focused for the best results.
2 changes: 2 additions & 0 deletions docs/contributing/leadership/new-core-contributors-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,4 +48,6 @@ When this happens we usually follow this framework:

As a core contributor, you are eligible for a sponsored [Cursor] subscription. The process is simple: purchase your [Cursor] subscription, and then submit the expense to OpenCollective for reimbursement. To minimize administrative overhead, we encourage you to submit expenses quarterly rather than monthly. This benefit has been pre-approved for all core contributors, so there's no need to request permission - simply follow the reimbursement process through OpenCollective.

Some helpful Cursor usage tips can be found [here](./cursor-ide.md).

[Cursor]: https://www.cursor.com