Sign InGet Started

Cursor

Connect Cursor IDE to enable Cloud Agents that can run Tasks directly in your codebase.

Overview

The Cursor Connection is different from other Connections. While GitHub, Linear, Slack, and Notion give the AI read access to data for context, the Cursor Connection enables a different capability: Cloud Agents that can perform coding Tasks inside your development environment.

When Cursor is connected, Hamster can delegate coding work to an agent running in your Cursor IDE — writing code, applying changes, and working through Tasks while you focus on other things.

This is an advanced feature that operates on your local development environment. It requires an active Cursor installation with an active session.

What It Enables

  • Background coding Tasks — Agents can work on implementation Tasks in your codebase
  • Code changes — The agent can write new files, modify existing ones, and apply diffs

The Cursor Connection is distinct from the read-only context Connections. It allows the agent to take action, not just retrieve information.

How to Connect

  1. Go to Connections and click the Cursor card.
  2. In the dialog, enter your Cursor API Key.
  3. Hamster validates your key before allowing you to save the Connection. If the key is invalid or expired, you'll see a specific error message (e.g., "Invalid API key" or "Key has expired").
  4. Click Connect to save the Connection.

The Connection is ready once saved. Unlike OAuth Connections, there is no redirect to an external site.

If the Connection fails after being saved (e.g., due to key expiration or Cursor account changes), the Connection will show a Reconnect required badge on your Connections page. Click the Connection and re-enter your API key to restore access.

Getting Your Cursor API Key

Your Cursor API key is available in the Cursor settings. The expected format is key_ followed by alphanumeric characters (e.g. key_abc123xyz).

To find it:

  1. Open Cursor.
  2. Go to Cursor Settings.
  3. Find your API key in the account or API section.

One Connection Per Workspace

Cursor is a single-connection service per workspace. You can have one active Cursor Connection per workspace. Once connected, the Cursor card no longer appears in the Add Connections grid. To change the connected Cursor account, remove the existing Connection first and then add a new one.

Tips

  • Cloud Agents work best on well-defined, scoped Tasks. Providing clear Task descriptions and context produces better results than open-ended requests.
  • The agent operates in your local Cursor environment. Make sure Cursor is running and your project is open when you want the agent to work.
  • Review changes made by the agent before committing them. Cloud Agents can make mistakes, particularly on complex or ambiguous Tasks.
  • Connecting GitHub alongside Cursor helps the agent understand your repository structure and code conventions before making changes.

Related