Cursor cli

Skill HKTITAN/cursor-sdk/skills/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.From its SKILL.md

Install

npx -y skills add HKTITAN/cursor-sdk --skill cursor-cli

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

1.9 KB, 400 tokens by cl100k_base, as published. Nobody here has run it

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]] — agent REPL
[[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_KEY secret
[[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]]

What ships with it: 12 files

6.8 KB alongside SKILL.md