# Cursor

Use Cursor with Buddy to deploy your project, trigger and monitor pipelines, and debug builds without leaving your editor.

Cursor is an AI-first code editor built around an agent that understands your entire project. It reads across the codebase, runs commands, edits files wherever changes are needed, and keeps your work moving without leaving the editor. Paired with Buddy, Cursor can deploy your project and let Buddy handle the entire deployment workflow. On top of that, it can trigger and monitor your pipelines, ship changes across environments, and dig through build output and logs when something needs fixing.

<Hint type="info">
This page covers working with Buddy from within Cursor. On top of that, you can run AI coding agents in a fully isolated Buddy sandbox - see [Run agents in a sandbox](/docs/ai-agents/sandboxes.md).
</Hint>

## Quick start

<Steps>
  <Step title="Install the Buddy CLI">
    ```bash
    npm install -g bdy
    ```
  </Step>
  <Step title="Log in to Buddy">
    ```bash
    bdy login
    ```
  </Step>
  <Step title="Link your project">
    Run this inside your project directory to connect it to a Buddy project:

    ```bash
    bdy proj link
    ```
  </Step>
  <Step title="Install the Buddy skill">
    ```bash
    npx skills add buddy/buddy-plugin
    ```
  </Step>
  <Step title="Open Cursor and start the agent">
    Open your project in Cursor and start the agent (⌘I / Ctrl+I). You can also launch it from the terminal with the Cursor CLI:

    ```bash
    cursor-agent
    ```
  </Step>
  <Step title="Prompt the agent">
    Ask it to build and ship something end to end, for example:

    ```text
    Create a snake app and deploy it for me
    ```
  </Step>
</Steps>

## Example prompts

Once the agent is running and your project is linked to Buddy, try prompts like:

- Create a Next.js app and deploy it to production.
- Deploy an Umami analytics instance and wire it into my app.
- Deploy an AI chatbot with Postgres for history and Redis for rate limiting.
- Deploy my app, set up a CDN, and buy and configure a domain with SSL.
- Add a pipeline that runs on every change in the repository and executes my test suite.
- Add a pipeline that runs every minute, checks that my site is up, and sends a notification to Slack, email, Telegram, or SMS if anything is wrong.
- Check the last few CI pipeline runs for failures, read the logs, and fix the failing tests.
- Analyze the logs from the last production deployment and fix the errors.
- Find the last successful production deployment and roll back to it.
- Check my app logs and open issues based on what you find.

## Connect MCP

Give Cursor access to Buddy over MCP so it can run pipelines, manage deployments, and read logs. See the [MCP](/docs/ai-agents/mcp.md) page for the regional server URLs and how to filter the exposed tool categories.

Add the server to `.cursor/mcp.json` in your project (or `~/.cursor/mcp.json` for all projects):

```json
{
  "mcpServers": {
    "buddy": {
      "url": "https://mcp.buddy.works/mcp"
    }
  }
}
```

Or ask Cursor to set it up for you:

```text
Add the Buddy MCP server (https://mcp.buddy.works/mcp) to your MCP configuration.
```


---
Original source: https://buddy.works/docs/ai-agents/agents/cursor