Skip to main content
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.

​
Open the Cursor configuration

1

Go to Integrations

Navigate to app.atcyrus.com/settings/integrations.
2

Open the configuration modal

Find the Cursor tile, click the dropdown on the right side of the tile, and select Configure.

​
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

1

Open the Cursor dashboard

Go to cursor.com/dashboard?tab=integrations.
2

Create a new User API Key

Click New User API Key and name it Cyrus.
3

Copy the key

Copy the generated API key immediately.
4

Paste it into Cyrus

Back in the Cyrus Cursor configuration modal, paste the key into the input field and save.

​
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:

Cursor CLI Installation

Official instructions for installing the Cursor CLI on macOS, Linux, and Windows.
After installing, confirm the CLI is available:
If this prints a version number, you’re ready to go.
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.

​
Troubleshooting

agent: command not found
  • Ensure the Cursor CLI is installed following the official guide
  • Verify it’s on your PATH by running which agent
Cursor not being used for issues

​
Next steps

To make Cursor the provider Cyrus uses for every issue, see Default Model Provider.
cyrus-f1

Cyrus Community

Get support on Discord