Cursor Local

Cursor Local

cursor runs Cursor's Agent CLI on the same machine as Paperclip. Use it when you want Cursor chat session resume across heartbeats and structured stream output in run logs.

---

When To Use

You already use Cursor Agent CLI locally. You want Paperclip to run Cursor with session resume (--resume) across heartbeats. You want structured stream output (--output-format stream-json) in run logs.

When Not To Use

You need webhook-style external invocation. Use OpenClaw Gateway (/docs/adapters/openclaw-gateway) or HTTP (/docs/adapters/http). You only need one-shot shell commands. Use Process (/docs/adapters/process). Cursor Agent CLI is not installed or not available on PATH.

---

Common Fields

| Field | Required | Notes | |---|---:|---| | cwd | no | Absolute working directory. Recommended. Created when permissions allow; otherwise falls back to the process working directory. | | model | no | Cursor model id. Defaults to auto. Common choices include auto, composer-1.5, gpt-5.3-codex, opus-4.6-thinking, sonnet-4.6, gemini-3-pro, grok. | | mode | no | Cursor execution mode passed as --mode. Accepts plan or ask. Leave unset for normal autonomous runs. | | promptTemplate | no | Run prompt template. | | instructionsFilePath | no | Absolute path to a Markdown instructions file prepended to the run prompt. | | command | no | Defaults to agent. Override only for a non-default executable path. | | extraArgs | no | Extra CLI arguments appended to the Cursor invocation. | | env | no | Environment variables. Secret refs supported. | | timeoutSec | no | Run timeout in seconds. 0 means no timeout. | | graceSec | no | SIGTERM grace period before a forced stop. |