cursor-models

The SDK exposes the same model catalog as the Cursor app. Pick at create time, override per run, and tune via params.

When to use

• Listing available models for a UI / config
• Choosing between cost and capability (Composer 2 vs GPT-5.5 etc.)
• Tuning model parameters like thinking depth
• Routing different workload classes to different models

Catalog

• [[references/list]] — Cursor.models.list() returns SDKModel[]
• [[references/model-shape]] — id, displayName, description, parameters, variants
• [[references/parameters]] — ModelParameterDefinition and value enums

Selection

• [[references/model-selection]] — { id, params? }
• [[references/sticky-model]] — per-run override semantics
• [[references/routing]] — pattern for class→model maps

Cross-links

• Agent.create({ model }) → [[../cursor-sdk/references/agent-create]]
• Per-run override → [[../cursor-runs/references/send-options]]
• Subagent inheritance → [[../cursor-subagents/references/model-inheritance]]