# Cursor Models

> Model discovery and selection on Cursor SDK — Cursor.models.list, ModelSelection, parameters (e.g. thinking levels), per-run sticky overrides.

- Skill: `hktitan/cursor-models` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add hktitan/cursor-models`
- Raw SKILL.md: https://api.skillmd.com/api/skills/hktitan/cursor-models/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: HKTITAN (https://skillmd.com/u/hktitan)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/hktitan/cursor-models

---


# 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]]