# Cursor Agent

import { Callout } from "nextra/components";

<Callout type="info">
  Cursor Agent is available in Pane on macOS and Linux. It isn't available in Pane on Windows yet.
</Callout>

## Install

```bash
curl https://cursor.com/install -fsS | bash
```

The installer puts `cursor-agent` in `~/.local/bin`. If your shell can't find it, add that folder to your `PATH` as the installer directs.

## Authenticate

```bash
cursor-agent login
```

Your browser will open so you can sign in with your Cursor account. Check the result:

```bash
cursor-agent status
```

## Check Pane can find it

Run this from a repo you've added to Pane:

```bash
runpane agents doctor --agent cursor --repo active
```

This checks the same repo environment Pane will use. If it can't find Cursor Agent, restart Pane after fixing your `PATH`.

## Launch

Press <KeyCombo keys={["⌘", "⌥", "5"]} /> or open the Command Palette → **Add Cursor**.

Pane opens Cursor Agent in the pane's worktree. That's its own branch in a separate folder, safely isolated from your other panes.

<TerminalPreview lines={[
  { type: "command", text: "cursor-agent" },
  { type: "output", text: "Cursor Agent" },
  { type: "output", text: "" },
  { type: "command", text: "Fix the failing checkout tests" },
  { type: "success", text: "✓ Updated the checkout tests" },
]} />

Review the changes in Pane's **Diff** tab before you commit them.

## Start Cursor Agent from RunPane

You can also create a pane and start Cursor Agent in one command:

```bash
runpane panes create \
  --repo active \
  --name fix-checkout-tests \
  --agent cursor \
  --prompt "Fix the failing checkout tests" \
  --wait-ready \
  --yes
```

Pane starts Cursor Agent with `--force --trust`. That lets your prompt drive the agent without another approval step. Review the diff before you commit or push.

See [Cursor's CLI docs](https://docs.cursor.com/en/cli/overview) for models, sessions, rules, and permission settings.