agent models

Lists all models available for the account.

agent models shows the list of models usable by the currently signed-in account. This is the same result as agent --list-models. A model is then selected separately, either with --model <model> at startup or via /model in a running session.

✅ WHEN TO USE IT?

Check the exact model name to use before a script run

agent models

Pipe the available models into another tool or script

agent --list-models > models.txt

⛔ WHEN NOT TO?

You just want to switch the model for the current session

agent models only lists models, it doesn't switch anything.

Better: Use /model in the running chat, or set --model <model> at startup

You're already in an interactive session and want a quick switch

A new agent models call would mean a new session or process.

Better: Use /model directly inside the running session

SOURCES

Cursor Docs — CLI Reference: Parameters ↗ cursor.com