#3649: docs: remove numeric model selection references and document /models
docs
size: XS
Cluster:
Model Management Enhancements
## Summary
- Update `/model` docs to reflect summary view and alias/provider syntax
- Remove numbered picker and `/model <#>` references
- Add `/models` and `/models <provider>` guidance
## Why
PR #1398 (Jan 21, 2026) removed numeric model selection from chat, but the docs were never updated. Users see `/model 3` in docs but get "Numeric model selection is not supported in chat" when they try it.
## Files Changed
- `docs/concepts/models.md`
- `docs/tools/slash-commands.md`
- `docs/help/faq.md`
## Testing
- [x] Docs-only change, no code testing needed
- [x] Verified examples match current `/model` behavior
## AI Disclosure 🤖
This PR was drafted with Claude (Opus 4.5) assistance. The changes are straightforward docs updates that I understand and have verified against the actual code behavior.
<!-- greptile_comment -->
<h2>Greptile Overview</h2>
<h3>Greptile Summary</h3>
Docs update aligns model-selection guidance with current chat behavior: removes numeric `/model <#>` examples, documents `/model` summary + `provider/model` and alias usage, and introduces `/models` / `/models <provider>` discovery guidance.
Main inconsistency spotted: the slash-command list still claims `/models` is an alias of `/model`, which conflicts with the new `/models` semantics.
<h3>Confidence Score: 4/5</h3>
- This PR is safe to merge with minimal risk, but has a couple doc inconsistencies that should be corrected.
- Docs-only changes and the intent is clear, but there are conflicting statements about `/models` (alias vs distinct command) and some leftover `/model list` references that could mislead users.
- docs/tools/slash-commands.md (command list entry) and docs/help/faq.md (remaining `/model list` references).
<!-- greptile_other_comments_section -->
<sub>(3/5) Reply to the agent's comments like "Can you suggest a fix for this @greptileai?" or ask follow-up questions!</sub>
<!-- /greptile_comment -->
Most Similar PRs
#9905: fix: require provider prefix for models set without alias (#5790)
by petter-b · 2026-02-05
76.5%
#6673: fix: preserve allowAny flag in createModelSelectionState for custom...
by tenor0 · 2026-02-01
76.1%
#11198: fix(models): strip @profile suffix from model selection
by mcaxtr · 2026-02-07
75.9%
#11115: [AI-assisted] Add /model-set chat command with autocompletion and s...
by dorgonman · 2026-02-07
75.8%
#9583: fix(models): allow models in agents.defaults.models even if not in ...
by hotzen100 · 2026-02-05
75.8%
#20136: Telegram: fix cross-provider model checkmark in /models keyboard
by powerdot · 2026-02-18
75.6%
#19927: fix(agents): replace hardcoded Anthropic model IDs with pattern mat...
by Milofax · 2026-02-18
75.4%
#6440: feat(ui): add model picker dialog with provider filtering
by igorls · 2026-02-01
75.2%
#18697: fix: include forward-compat models in model catalog for allowlist val…
by dmitry-orabey · 2026-02-17
75.1%
#8083: fix(tui): update model status immediately after /model command
by rohanjangala · 2026-02-03
75.0%