How do I install the Omega Cursor CLI skill?

Run npx skillmds@latest add oimiragieo/omega-cursor-cli in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Omega Cursor CLI safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Omega Cursor CLI?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Omega Cursor CLI free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Omega Cursor CLI?

oimiragieo (@oimiragieo) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Omega Cursor CLI by oimiragieo — Agent Skill

Name: Omega Cursor CLI
Rating: 4.5 (4 reviews)
Author: oimiragieo

File contents

Cursor CLI Skill

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

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

Anti-Pattern	Why Bad	Correct Approach
Running without --yolo	Blocks on tool approval prompts	Always pass --yolo
Running without --trust	Blocks on workspace trust prompt	Always pass --trust
Assuming auto model is available	Depends on subscription tier	Check with cursor-agent --list-models
Hardcoding cursor-agent path	PATH differs across OS/install methods	Wrapper handles resolution
Ignoring WSL requirements	Some Windows installs are WSL-only	Document in setup instructions

Scripts

Script	Purpose
`ask-cursor.mjs`	Core headless wrapper -- prompt as last positional arg
`parse-args.mjs`	Argument parser (--model, --json, --yolo, --trust, --timeout-ms)
`verify-setup.mjs`	Availability check (multi-path resolution)
`format-output.mjs`	Output normalization

Exit Codes

Code	Meaning
0	Success
1	Error (CLI failure, subscription issue)
124	Timeout (--timeout-ms exceeded)

Integration Notes

Subscription: Cursor Pro or Business required for agent/headless mode
Stdin limit: ASK_CURSOR_MAX_STDIN_BYTES env var (default 50MB)
Available models: claude-4.6-opus, claude-4.6-sonnet, composer-1.5, gemini-3.1-pro, gpt-5.3-codex, auto
Platform: Partial cross-platform (WSL issues on some Windows configurations)
PATH resolution order: agent -> cursor-agent -> %LOCALAPPDATA%\cursor-agent\cursor-agent.cmd -> npx @cursor/agent

Memory Protocol

Before work: Read .claude/context/memory/learnings.md After work: Append findings to learnings or issues as needed.

Note: Use pnpm search:code to discover references to this skill codebase-wide.

---name: omega-cursor-clidescription: 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.---# Cursor CLI Skill<identity>Headless wrapper for Cursor Agent CLI. Passes prompt as last positional argto `cursor-agent --print --output-format text`. Multi-model routing via --model auto.Requires paid Cursor subscription.</identity><capabilities>- 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</capabilities>## Usage### Ask a question (auto model selection)```bashnode .claude/skills/omega-cursor-cli/scripts/ask-cursor.mjs "How should I structure this React component?" --yolo --trust```### Specific model```bashnode .claude/skills/omega-cursor-cli/scripts/ask-cursor.mjs "Review this API design" --model claude-4.6-opus --yolo --trust```### With timeout```bashnode .claude/skills/omega-cursor-cli/scripts/ask-cursor.mjs "Refactor authentication" --yolo --trust --timeout-ms 180000```### JSON output```bashnode .claude/skills/omega-cursor-cli/scripts/ask-cursor.mjs "Generate types" --json --yolo --trust```## Availability Check```bashnode .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 Laws1. ALWAYS use --yolo --trust for headless mode (otherwise blocks on approval prompts)2. NEVER assume CLI is available -- most restrictive subscription requirement3. ALWAYS include --timeout-ms for production usage4. 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 | Correct Approach || -------------------------------- | -------------------------------------- | ------------------------------------- || Running without --yolo | Blocks on tool approval prompts | Always pass --yolo || Running without --trust | Blocks on workspace trust prompt | Always pass --trust || Assuming auto model is available | Depends on subscription tier | Check with cursor-agent --list-models || Hardcoding cursor-agent path | PATH differs across OS/install methods | Wrapper handles resolution || Ignoring WSL requirements | Some Windows installs are WSL-only | Document in setup instructions |## Scripts| Script | Purpose || ------------------- | ---------------------------------------------------------------- || `ask-cursor.mjs` | Core headless wrapper -- prompt as last positional arg || `parse-args.mjs` | Argument parser (--model, --json, --yolo, --trust, --timeout-ms) || `verify-setup.mjs` | Availability check (multi-path resolution) || `format-output.mjs` | Output normalization |## Exit Codes| Code | Meaning || ---- | --------------------------------------- || 0 | Success || 1 | Error (CLI failure, subscription issue) || 124 | Timeout (--timeout-ms exceeded) |## Integration Notes- **Subscription:** Cursor Pro or Business required for agent/headless mode- **Stdin limit:** `ASK_CURSOR_MAX_STDIN_BYTES` env var (default 50MB)- **Available models:** claude-4.6-opus, claude-4.6-sonnet, composer-1.5, gemini-3.1-pro, gpt-5.3-codex, auto- **Platform:** Partial cross-platform (WSL issues on some Windows configurations)- **PATH resolution order:** agent -> cursor-agent -> %LOCALAPPDATA%\cursor-agent\cursor-agent.cmd -> npx @cursor/agent## Memory ProtocolBefore work: Read `.claude/context/memory/learnings.md`After work: Append findings to learnings or issues as needed._Note: Use `pnpm search:code` to discover references to this skill codebase-wide._

Frequently asked questions

Omega Cursor CLI