Cursor Cli
The `agent` CLI — install, interactive modes (Agent / Plan / Ask), headless `-p` mode for CI, GitHub Actions integration, and how it relates to the TypeScript SDK. Use when scripting Cursor in shell pipelines or workflows instead of (or alongside) the SDK.
Install
$ agentstack add skill-hktitan-cursor-sdk-cursor-cli ✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ● Network access Used
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
Verified badge
Passed review? Show it. Paste this badge into your README, it links to the public security report.
Links to your public security report.[](https://agentstack.voostack.com/security/report/skill-hktitan-cursor-sdk-cursor-cli) Reliability & compatibility
Declared compatibility
Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.
We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.
How agent discovery & health will work →About
cursor-cli
The CLI ships the same agent runtime as the SDK and the editor — pick it when shell-script ergonomics beat a TypeScript program. The SDK is the right choice when you need streaming events, durable cloud reattachment, or programmatic subagents; the CLI is the right choice for one-off prompts and CI gates.
When to use
- One-off prompts in a terminal
- CI / GitHub Actions jobs that operate on a repo
- Headless scripted runs with structured output
- Quick local experiments before promoting to SDK code
Install & auth
- [[references/install]] — curl / PowerShell installers,
$HOME/.cursor/bin - [[references/auth]] —
CURSOR_API_KEY, login flow
Interactive
- [[references/interactive]] —
agentREPL - [[references/modes]] — Agent / Plan / Ask,
--mode, Shift+Tab - [[references/sessions]] —
agent resume,agent --continue - [[references/cloud-handoff]] —
&-prefix for background
Headless
- [[references/headless]] —
-p / --print,--force / --yolo - [[references/output-formats]] —
text/json/stream-json,--stream-partial-output - [[references/exit-codes]] —
$?in shell scripts
CI / automation
- [[references/github-actions]] — workflow snippet,
CURSOR_API_KEYsecret - [[references/permissions]] — restricting agent autonomy in CI
Compared to the SDK
- [[references/cli-vs-sdk]] — when to pick which
Cross-links
- SDK entry point → [[../cursor-sdk/SKILL]]
- Models flag → [[../cursor-models/SKILL]]
- Rules / skills the CLI loads → [[../cursor-rules/SKILL]] · [[../cursor-skills-system/SKILL]]
Source & license
This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.
- Author: HKTITAN
- Source: HKTITAN/cursor-sdk
- License: MIT
- Homepage: https://skills.sh/hktitan/cursor-sdk
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet, be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.