用途:以无头方式(headless)调用 Cursor Agent CLI,执行需要工作区上下文的代码任务,例如代码生成、设计评审、重构与类型生成,并可借 Cursor 的 auto 路由获得多模型视角。
主要能力:ask-cursor.mjs 为核心无头封装,提示词作为最后一个位置参数;支持指定模型(如 claude-4.6-opus、claude-4.6-sonnet、composer-1.5、gemini-3.1-pro、gpt-5.3-codex、auto)、JSON 输出与超时控制;verify-setup.mjs 做可用性检查(多路径解析),parse-args.mjs 解析参数,format-output.mjs 规范化输出。退出码:0 成功,1 错误(CLI 失败或订阅问题),124 超时。
用法示例: node .claude/skills/omega-cursor-cli/scripts/ask-cursor.mjs "How should I structure this React component?" --yolo --trust node .claude/skills/omega-cursor-cli/scripts/ask-cursor.mjs "Review this API design" --model claude-4.6-opus --yolo --trust node .claude/skills/omega-cursor-cli/scripts/ask-cursor.mjs "Refactor authentication" --yolo --trust --timeout-ms 180000 node .claude/skills/omega-cursor-cli/scripts/ask-cursor.mjs "Generate types" --json --yolo --trust node .claude/skills/omega-cursor-cli/scripts/verify-setup.mjs(退出 0 表示可用)
适用场景:需要 Cursor 工作区上下文的无头代码任务、希望获得非 Claude/非 OpenAI 视角、以及 Cursor composer 模型擅长的任务。
限制与注意:无头模式必须加 --yolo --trust,否则会阻塞在工具审批与工作区信任提示上;生产使用应始终带 --timeout-ms;CLI 可用性不可假定(订阅要求最严格),可用 cursor-agent --list-models 检查模型,但无法以程序方式检测订阅状态;部分 Windows 配置需要 WSL;stdin 上限由 ASK_CURSOR_MAX_STDIN_BYTES 控制(默认 50MB);PATH 解析顺序为 agent -> cursor-agent -> %LOCALAPPDATA%\cursor-agent\cursor-agent.cmd -> npx @cursor/agent。需 Cursor Pro 或 Business 订阅方可使用 agent/无头模式。其他细节暂未提供。