omega-cursor-cli

name	omega-cursor-cli
description	Use when the user asks to run Cursor Agent CLI headless from an agent workflow (analysis, brainstorming, second opinion, scripted CLI output). Trigger on requests like "ask cursor", "run cursor headless", "analyze with cursor", or "brainstorm with cursor".

Omega Cursor CLI

Use the shared headless wrapper to run Cursor Agent from this project without MCP.

Run

From project root:

node .claude/skills/omega-cursor-cli/scripts/ask-cursor.mjs "USER_PROMPT"

Supported options:

• --model MODEL — use auto or run cursor-agent --list-models for current IDs (e.g. composer-2.5-fast, claude-sonnet-5-thinking-medium)
• --mode plan|ask — read-only planning or Q&A
• --plan — shorthand for --mode plan
• --json (maps to cursor-agent --output-format json)
• --yolo (maps to cursor-agent --yolo / --force, auto-approves all tool calls)
• --trust (maps to cursor-agent --trust, trusts workspace without prompting)
• --approve-mcps (maps to cursor-agent --approve-mcps, auto-approves MCP servers)
• --sandbox enabled|disabled (maps to cursor-agent --sandbox; not auto-approve)
• --timeout-ms N

Setup and troubleshooting

1. Run:

node .claude/skills/omega-cursor-cli/scripts/verify-setup.mjs

2. If Cursor Agent is missing, install with the official installer:

curl https://cursor.com/install -fsS | bash
# Windows PowerShell: irm 'https://cursor.com/install?win32=true' | iex

3. If auth is required, run cursor-agent login once, or set CURSOR_API_KEY.

See references:

• references/headless.md
• references/cursor-agent.md
• references/installation.md
• references/auth.md
• references/copy-and-run.md