Choose which model the agent uses

modes & models

// what it does

--model picks the model for a single run; --list-models prints every model available to your account so you can see valid names first. This works in both interactive and print mode. Without --model the CLI uses whatever model is persisted in your config.

// shell

$ cursor-agent --list-models
$ cursor-agent -p "review these changes" --model "gpt-5"

// gotcha

Model names must match --list-models exactly and depend on your plan — an unknown --model value errors out instead of silently falling back to the default, which is easy to hit when a model is renamed or deprecated.

// resources