Start an interactive agent session

sessions

// what it does

Running cursor-agent with no flags opens the conversational TUI in your current directory in Agent mode, with full read/write/shell tools. Passing a prompt as an argument seeds the session and the agent starts working on it immediately. Before running any terminal command it asks you to approve (y) or reject (n).

// shortcut

Ctrl+D

// shell

$ cursor-agent
$ cursor-agent "refactor the auth module to use JWT tokens"

// gotcha

Ctrl+C cancels the current action, not the app — to actually quit press Ctrl+D twice (standard shell double-press), or use /quit.

// resources