| 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
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
- ALWAYS use --yolo --trust for headless mode (otherwise blocks on approval prompts)
- NEVER assume CLI is available -- most restrictive subscription requirement
- ALWAYS include --timeout-ms for production usage
- NEVER attempt to detect subscription status programmatically (not possible)
- ALWAYS handle WSL issues on Windows (some configurations require WSL)
Anti-Patterns
