cursor-models
Model discovery and selection on Cursor SDK — Cursor.models.list, ModelSelection, parameters (e.g. thinking levels), per-run sticky overrides.
Source facts
- Repository
- HKTITAN/cursor-sdk
- Last source activity
- May 3, 2026 at 08:23
- Detected SKILL.md language
- English
- Stars
- 2
- Forks
- 0
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
File Explorer
7 filesShowing SKILL.md
SKILL.md
Source instructions · Read-only preview- name
- cursor-models
- description
- Model discovery and selection on Cursor SDK — Cursor.models.list, ModelSelection, parameters (e.g. thinking levels), per-run sticky overrides.
- metadata
- {"internal":false,"source":"https://cursor.com/docs/sdk/typescript"}
# 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]]
View on GitHub