@meetopenbot/cursor

OpenBot agent plugin powered by the Cursor TypeScript SDK.

Cursor provides a full agent runtime with built-in tools (shell, read, edit, write, grep, and more), session management, and local or cloud execution. This plugin wraps Cursor as an OpenBot agent runtime — each agent:invoke runs a Cursor turn and streams progress back via agent:output.

Installation

npm install @meetopenbot/cursor

Add the plugin to your agent in AGENT.md:

plugins:
  - id: '@meetopenbot/cursor'
    config:
      model: composer-2.5
      thinking: high
      runtime: local

Configuration

| Option | Description | |--------|-------------| | apiKey | Cursor API key. Falls back to CURSOR_API_KEY. | | runtime | local (default) or cloud. | | model | Model id (default: composer-2.5). | | thinking | Reasoning effort for models that support it (e.g. low, high). | | mode | agent (default) or plan. | | cwd | Working directory for local agents. Defaults to the OpenBot channel cwd, then process.cwd(). | | repoUrl | Git repository URL for cloud agents. | | startingRef | Git ref to clone for cloud agents (e.g. main). | | autoCreatePR | Open a pull request when a cloud run finishes. | | workOnCurrentBranch | Push cloud commits to the existing branch. | | settingSources | Comma-separated local settings layers: project, user, team, mdm, plugins, all. | | sandbox | Enable the local agent sandbox. | | autoReview | Route local tool calls through Auto-review. |

API Keys

Set CURSOR_API_KEY in the environment or pass apiKey in plugin config. Generate a key from Cursor Dashboard → API Keys.

Sessions

Each OpenBot thread gets its own Cursor agent. The Cursor agentId is stored in thread state so conversations continue across turns. The plugin uses Agent.resume() to reconnect after restarts.

License

MIT