> ## Documentation Index
> Fetch the complete documentation index at: https://atcyrus.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor

> How to configure Cursor for use with Cyrus

Set up Cursor so Cyrus can use it as a coding agent when processing your issues.

Once configured, you can make Cursor your [default model provider](/providers/default-model-provider).

***

## Open the Cursor configuration

<Steps>
  <Step title="Go to Integrations">
    Navigate to [app.atcyrus.com/settings/integrations](https://app.atcyrus.com/settings/integrations).
  </Step>

  <Step title="Open the configuration modal">
    Find the **Cursor** tile, click the **dropdown** on the right side of the tile, and select **Configure**.
  </Step>
</Steps>

***

## Supported models

Cyrus runs Cursor with the **`composer-2`** model by default. Cursor's CLI manages model selection internally, so per-issue model overrides are not currently exposed for the Cursor provider.

***

## Generate a Cursor API key

<Steps>
  <Step title="Open the Cursor dashboard">
    Go to [cursor.com/dashboard?tab=integrations](https://cursor.com/dashboard?tab=integrations).
  </Step>

  <Step title="Create a new User API Key">
    Click **New User API Key** and name it `Cyrus`.
  </Step>

  <Step title="Copy the key">
    Copy the generated API key immediately.
  </Step>

  <Step title="Paste it into Cyrus">
    Back in the Cyrus Cursor configuration modal, paste the key into the input field and save.
  </Step>
</Steps>

***

## Self-hosted setup

If you're running Cyrus in **self-host** mode, you also need to install **cursor-agent** (the `agent` CLI) on the machine where Cyrus runs.

Follow the official installation guide:

<Card title="Cursor CLI Installation" icon="arrow-up-right-from-square" href="https://cursor.com/docs/cli/installation" horizontal>
  Official instructions for installing the Cursor CLI on macOS, Linux, and Windows.
</Card>

After installing, confirm the CLI is available:

```bash theme={null}
agent --version
```

If this prints a version number, you're ready to go.

<Warning>
  Make sure `agent` is on your system `PATH` so Cyrus can find it at runtime. If you installed via a package manager this is usually handled automatically.
</Warning>

***

## Troubleshooting

**`agent: command not found`**

* Ensure the Cursor CLI is installed following the [official guide](https://cursor.com/docs/cli/installation)
* Verify it's on your `PATH` by running `which agent`

**Cursor not being used for issues**

* Confirm Cursor is configured in your [Cyrus integrations](https://app.atcyrus.com/settings/integrations)
* Check that your API key is valid and hasn't been revoked in the [Cursor dashboard](https://cursor.com/dashboard?tab=integrations)

***

## Next steps

To make Cursor the provider Cyrus uses for every issue, see [Default Model Provider](/providers/default-model-provider).

<Card title="Cyrus Community" href="https://discord.com/invite/prrtADHYTt" img="https://mintcdn.com/ceedaraiinc/75NMRUlNh03-gDHX/images/cyrus-f1.png?fit=max&auto=format&n=75NMRUlNh03-gDHX&q=85&s=947d2de0018937ce613572349bc91f06" width="1120" height="928" data-path="images/cyrus-f1.png">
  Get support on Discord
</Card>