cursor-cli

name	cursor-cli
description	Cursor CLI reference. Use when running Cursor in interactive_shell overlay or when user asks about Cursor CLI options.

Cursor CLI

Commands

Command	Description
agent	Start interactive Cursor session
agent "prompt"	Interactive session with initial prompt
agent -p "prompt"	Non-interactive print mode
agent ls	List previous chats
agent resume	Resume latest chat
agent --continue	Continue previous session
agent --resume "chat-id"	Resume a specific chat

Key Flags

Flag	Description
--mode plan / --plan	Plan mode (clarify before coding)
--mode ask	Ask mode (read-only exploration)
--model <model>	Model override
`--sandbox <enabled	disabled>`
--output-format text	Output 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' })