cursor-cli

@qyjqio/dsh-cursor-cli

DSH host plugin that adds the cursor_agent tool: run the Cursor CLI (cursor-agent) headlessly on a task in a workspace, straight from any DSH agent session.

Cursor runs its own agent loop (reads/edits files, calls tools) and the tool returns its final message plus the Cursor chat id, so a run can be continued later with resume.

Install

# from a DSH session with the plugin manager available — git source, pinned by the market index
plugin_manager install_bundle target="git+https://github.com/qyjqio/dsh-cursor-toolkit.git#<commit>&path:/packages/dsh-cursor-cli"

# or plain pnpm, inside a DSH profile directory
pnpm add "git+https://github.com/qyjqio/dsh-cursor-toolkit.git#<commit>&path:/packages/dsh-cursor-cli"

Then enable the bundle (include:cursor-cli) in Settings → Plugins, or add @qyjqio/dsh-cursor-cli to the profile's dsh.profile.bundles.

Requirements

• Cursor CLI installed and logged in: cursor-agent --version, cursor-agent login.
• The executable is resolved from, in order: PATH, ~/.local/bin, /usr/local/bin, /usr/bin (override with the executable config field).
• Headless runs need the workspace trusted, so the tool always passes --trust.

Parameters

Result

{ ok, result, cwd, mode, truncated, timedOut, aborted,
  sessionId?, model?, durationMs?, exitCode?, stderr? }

ok is false when the process exits non-zero, Cursor reports is_error, or the run times out / is aborted. The rendered card shows the final message plus a footer with session id, model, mode, duration and cwd.

Config

Optional bundle config (all values are defaults in code when omitted):

Examples

• cursor_agent({ prompt: "Fix the failing test in tests/auth.spec.ts" })
• cursor_agent({ prompt: "Review src/api for error handling gaps", mode: "plan" })
• cursor_agent({ prompt: "Now apply the plan", resume: "<sessionId>" })

Notes

• Tools run with the host process environment, so CURSOR_API_KEY is honored.
• Timeout: the tool kills the CLI with SIGTERM, then SIGKILL after 3 s.
• cwd is validated before spawning; a missing directory fails fast instead of letting Cursor create one.