cursor

Start interactive agent session

$ cursor agent

$ cursor agent "Fix the authentication bug"

$ cursor agent -p "Add error handling to api.js"

$ cursor agent ls

$ cursor agent resume

$ cursor agent --resume="[chat-id]"

$ cursor agent --mode=plan "[task description]"

cursor agent [options] [prompt]

cursor is the command-line interface for Cursor, an AI-powered code editor. The CLI brings Cursor's AI coding capabilities to the terminal, allowing developers to write, review, debug, and test code without leaving their preferred environment.
The CLI operates in three modes: Agent mode (default) provides full access to all tools for complex coding tasks, Plan mode focuses on task decomposition and planning, and Ask mode handles questions and explanations.
Sessions are persistent and can be resumed later using agent ls and agent resume. The Cloud Agent feature (triggered with & prefix) allows tasks to run in the background while you continue working.
The CLI integrates with any terminal environment including Bash, Zsh, and terminal emulators like Warp. It works alongside other IDEs like Neovim, JetBrains, and Android Studio, enabling parallel agent execution.

-p prompt

Run in non-interactive print mode with specified prompt.

Specify AI model to use.

Operating mode: agent (default), plan, or ask.

Resume a specific conversation by ID.

Output format: text or other supported formats.

agent

Start interactive AI coding assistant session.

List all previous conversations.

Resume the most recent conversation.

/plan

Switch to Plan mode for task planning.

Switch to Ask mode for questions.

Toggle Plan mode.

Hand off task to Cloud Agent for background execution.

Requires an active Cursor subscription. The CLI uses the same models and quota as the Cursor editor application. Cloud Agent features require network connectivity. Installation requires curl and bash on Unix systems or PowerShell on Windows.

Cursor was founded in 2022 and launched as an AI-first code editor based on VS Code. The CLI was introduced in 2025 to extend Cursor's capabilities beyond the editor, enabling terminal-based workflows and headless operation. This allowed developers using alternative editors like Neovim or JetBrains IDEs to access Cursor's AI features.

claude(1), aider(1), vscode(1)