List available models with grok models

grok models prints the model catalog the CLI can use for the current account and config — built-in entries plus any custom models you defined. Official: CLI Reference, Grok Build overview.

List from the shell

grok models

Use the ids from that list with -m / --model on a run, or switch inside the TUI:

grok -p "Hello" -m <model-id>

/model <model-id>

/model also accepts the short alias /m.

Custom models and filters

Define OpenAI-compatible or Anthropic Messages endpoints in user ~/.grok/config.toml, then list again so the custom id appears — see Add a custom model in Grok Build.

Under [models] you can also shape what the picker shows:

Key	Purpose
default	Model for new sessions
allowed_models	Glob list restricting picker / -m
hidden_models	Hide from picker (still usable via -m)
disabled_models	Remove from the catalog (wins over hidden)

After edits, confirm discovery:

grok inspect
grok models

Pitfalls

• grok models is a catalog dump. Credit / billing view is /usage — see Check credit usage in Grok Build.
• Session-only switches with /model do not rewrite [models] default. Set the default in user config when every new session should start on that id.
• Auth must succeed first (grok login or XAI_API_KEY) or the catalog may be empty or incomplete.