Gemini

Use the Cursor headless CLI (cursor agent --print) for one-shot autonomous execution.

Workflow

1. Strip the leading /gemini token and preserve everything after it verbatim.
2. If the remaining prompt is empty, ask the user what Cursor should do.
3. Resolve scripts/run-cursor.sh relative to this skill directory and pipe the prompt to it on stdin.
4. Share Cursor's output with the user.
5. If Cursor changed files or made a concrete recommendation, summarize the important result in plain language.

Invocation

Default invocation from the current working directory:

PROMPT="<everything after /gemini>"
printf '%s' "$PROMPT" | "<skill-dir>/scripts/run-cursor.sh"

Useful options:

• --cd /path/to/project to run Cursor against a different working directory
• --mode plan for read-only planning/analysis (no file edits)
• --mode ask for Q&A explanations (read-only)
• --model <model> to override the default model (e.g., gpt-5, sonnet-4, sonnet-4-thinking)

Behavior

The helper script:

• checks that cursor is available on PATH
• uses --print --force --trust --output-format text for clean headless execution
• uses --workspace to set the working directory
• captures stdout and stderr separately to a temp directory
• returns only Cursor's text output on success
• fails clearly if Cursor exits non-zero or produces no output

Notes

• Do not describe this as a background dispatch unless you are actually using a background-capable shell tool.
• If Cursor fails, show the relevant error output instead of silently retrying.
• If cursor is missing, tell the user that Cursor CLI is not installed or not on PATH.
• Authentication uses the CURSOR_API_KEY env var or prior cursor agent login.