Cursor CLI
Apps & Automationcursor-cliCursor 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.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
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
| 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 forinteractive_shelloverlays. - 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' })