OpenParable
Skip to content
← Back to skills

Cursor CLI

Apps & Automation
cursor-cli

Cursor CLI is an Agent Skill for apps & automation published in the nicobailon/pi-interactive-shell repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Cursor CLI reference. Use when running Cursor in interactive_shell overlay or when user asks about Cursor CLI options.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/nicobailon/pi-interactive-shell/blob/HEAD/examples/skills/cursor-cli/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/cursor-cli, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Cursor CLI

Commands

CommandDescription
agentStart interactive Cursor session
agent "prompt"Interactive session with initial prompt
agent -p "prompt"Non-interactive print mode
agent lsList previous chats
agent resumeResume latest chat
agent --continueContinue previous session
agent --resume "chat-id"Resume a specific chat

Key Flags

FlagDescription
--mode plan / --planPlan mode (clarify before coding)
--mode askAsk mode (read-only exploration)
--model <model>Model override
`--sandbox <enableddisabled>`
--output-format textOutput format for print mode workflows

Mode Notes

  • Interactive mode (agent, agent "prompt") is the right fit for interactive_shell overlays.
  • Print mode (agent -p) is non-interactive and better suited to direct shell/batch usage.

In interactive_shell

Use structured spawn when you want the extension's shared spawn resolver/defaults/worktree support:

interactive_shell({ spawn: { agent: "cursor" }, mode: "interactive" })
interactive_shell({ spawn: { agent: "cursor", prompt: "Review the diffs" }, mode: "dispatch" })
interactive_shell({ spawn: { agent: "cursor", worktree: true }, mode: "hands-free" })

Structured spawn launches Cursor via the configured spawn.commands.cursor executable (default: agent) and appends prompt text as Cursor's native interactive startup form (agent "prompt"). By default, spawn args include --model composer-2-fast, which selects Cursor's Composer 2 Fast model explicitly.

Cursor remains fresh/worktree only in structured spawn. fork is Pi-only.

For non-interactive print-mode tasks, prefer direct shell usage:

bash({ command: 'agent -p "review these changes for security issues" --output-format text' })