Models

Copy Markdown View Source

CursorCliSdk.Models wraps agent models and parses the output into model entries.

{:ok, models} = CursorCliSdk.Models.list()

Enum.map(models, fn model ->
  {model.id, model.label, model.default?}
end)

Default Model

{:ok, maybe_default} = CursorCliSdk.Models.default_model()

The function returns {:ok, nil} when Cursor does not mark a default model in the command output.

Validate a Model

case CursorCliSdk.Models.validate_model("composer-2.5-fast") do
  :ok -> :ok
  {:error, {:unknown_model, model}} -> raise "unknown model: #{model}"
end

Validation is a live CLI check. It should be used in operator tooling, not in hot paths that need to avoid a subprocess call.

Parsing

parse/1 is pure and covered by fixture tests:

CursorCliSdk.Models.parse("""
* composer-2.5-fast Fast Composer
  other-model Other Model
""")

Lines beginning with * are treated as default-model entries.