@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