omega-cursor-cli

name	omega-cursor-cli
description	Shell out to Cursor Agent CLI for headless IDE-aware code tasks. Supports multi-model routing (auto mode routes to Claude, Gemini, GPT). Requires Cursor Pro/Business subscription.
version	1.0.0
model	sonnet
invoked_by	both
user_invocable	true
tools	["Bash","Read"]
args	"PROMPT" [--model MODEL] [--json] [--yolo] [--trust] [--timeout-ms N]
best_practices	["Always run verify-setup.mjs before first invocation","Cursor subscription is required -- most restrictive availability of all omega tools","Use --yolo for non-interactive headless mode (auto-approves all tool calls)","Use --trust for workspace trust without prompting","Use auto model for Cursor's intelligent model routing"]
error_handling	graceful
streaming	not_supported
verified	true
lastVerifiedAt	"2026-02-24T04:26:35.324Z"
source	builtin
trust_score	100
provenance_sha	b58306e870296cba

Cursor CLI Skill

Headless wrapper for Cursor Agent CLI. Passes prompt as last positional arg to `cursor-agent --print --output-format text`. Multi-model routing via --model auto. Requires paid Cursor subscription. - Headless Cursor Agent CLI invocation with positional prompt - Multi-model routing (auto, claude-4.6-opus, gemini-3.1-pro, gpt-5.3-codex, etc.) - JSON output mode - YOLO mode (auto-approve all tool calls for non-interactive use) - Trust mode (skip workspace trust prompts) - MCP approval mode (--approve-mcps) - Wrapper-level timeout with exit code 124 - Complex Windows PATH resolution (agent, cursor-agent, %LOCALAPPDATA%, npx fallback) - Availability verification

Usage

Ask a question (auto model selection)

node .claude/skills/omega-cursor-cli/scripts/ask-cursor.mjs "How should I structure this React component?" --yolo --trust

Specific model

node .claude/skills/omega-cursor-cli/scripts/ask-cursor.mjs "Review this API design" --model claude-4.6-opus --yolo --trust

With timeout

node .claude/skills/omega-cursor-cli/scripts/ask-cursor.mjs "Refactor authentication" --yolo --trust --timeout-ms 180000

JSON output

node .claude/skills/omega-cursor-cli/scripts/ask-cursor.mjs "Generate types" --json --yolo --trust

Availability Check

node .claude/skills/omega-cursor-cli/scripts/verify-setup.mjs
# Exit 0 = available (CLI found)
# Exit 1 = not available

When to Use

• Multi-model perspective via Cursor's auto routing
• IDE-aware code generation (Cursor has workspace context)
• When a non-Claude, non-OpenAI perspective is desired
• Tasks where Cursor's composer models excel

Iron Laws

1. ALWAYS use --yolo --trust for headless mode (otherwise blocks on approval prompts)
2. NEVER assume CLI is available -- most restrictive subscription requirement
3. ALWAYS include --timeout-ms for production usage
4. NEVER attempt to detect subscription status programmatically (not possible)
5. ALWAYS handle WSL issues on Windows (some configurations require WSL)

Anti-Patterns

Anti-Pattern	Why Bad