Menu
Cursor CLI reference. Use when running Cursor in interactive_shell overlay or when user asks about Cursor CLI options.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
OpenAI Codex CLI reference. Use when running codex in interactive_shell overlay or when user asks about codex CLI options.
Cheat sheet + workflow for launching interactive coding-agent CLIs (Claude Code, Gemini CLI, Codex CLI, Cursor CLI, and pi itself) via the interactive_shell overlay, headless dispatch, or monitor mode. Use for TUI agents and long-running processes that need supervision, fire-and-forget delegation, or event-driven background monitoring. Regular bash commands should use the bash tool instead.
How to write system prompts and instructions for GPT-5.3-Codex. Use when constructing or tuning prompts targeting Codex 5.3.
How to write system prompts and instructions for GPT-5.4. Use when constructing or tuning prompts targeting GPT-5.4.
Based on SOC occupation classification
| name | cursor-cli |
| description | Cursor CLI reference. Use when running Cursor in interactive_shell overlay or when user asks about Cursor CLI options. |
| 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 |
| 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 |
agent, agent "prompt") is the right fit for interactive_shell overlays.agent -p) is non-interactive and better suited to direct shell/batch usage.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' })