Skip to content

TUI: search/filter in the model picker for providers with large model lists (e.g. OpenRouter) #1557

Description

@Aaronontheweb

Problem

Some providers return a very large model catalog. OpenRouter is the worst offender (hundreds of models), but GitHub Copilot and the big hosted providers are heading the same way. In the TUI model picker the user is dropped into that full list and has to scroll through all of it to find the one model they want. We've had this raised by users before as an annoyance.

This is primarily a terminal-TUI (Termina) concern rather than a config/runtime one — the underlying model discover <provider> already returns the list fine; the friction is purely in how the interactive picker presents it.

Ask

Add a search / type-to-filter affordance to the model selection UI so the user can narrow a large list instead of scrolling it end to end. Rough shape:

  • Type-ahead filter box at the top of the picker; the list narrows as you type (substring match at minimum, fuzzy is nicer).
  • Filter on the model id (and any label/family we show).
  • Applies wherever we present a provider's models interactively: the init wizard model step, the netclaw model interactive picker, and the provider "discover models" view.
  • Should stay usable at ~300+ entries (OpenRouter scale) without lag.

Notes

  • Non-interactive paths (netclaw model discover, netclaw model set <role> <provider> <id>) already let you bypass the picker, so this is specifically about the interactive experience.
  • Out of scope: server-side / API-side filtering. This is a presentation-layer narrowing over the already-fetched list.

Filing as a UX/DX friction item.

Metadata

Metadata

Assignees

No one assigned

    Labels

    UX/DXUI / UX / DX friction issue or user-facing annoyances.enhancementNew feature or requesttuiTerminal UI (Termina) issues

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions