feat(cli): add interactive model catalog for /model command #4905

Githubguy132010 · 2026-01-09T15:26:50Z

Context

Replaces /model list and /model select with an interactive, searchable, paginated model catalog interface in the CLI so users can discover and pick models more easily across providers. This is intended to make the /model workflow faster and more discoverable while keeping backwards-compatible behavior (with deprecation warnings for the old commands).

Implementation

High level

Adds a Model Catalog UI mode for the CLI that shows models from all providers grouped by provider, with realtime search, pagination, sorting, and capability/provider filters.
Keeps the existing /model command entrypoint but opens the new interactive catalog; /model list and /model select will show deprecation warnings directing users to the new catalog.
Keyboard-first UX with common keys for discoverability (see How to Test).

Files added

cli/src/types/modelCatalog.ts — Type definitions for catalog entries and UI state
cli/src/state/atoms/modelSelection.ts — Recoil/state atoms for catalog mode and selections
cli/src/ui/components/ModelCatalogMenu.tsx — The interactive model catalog component

Files modified

cli/src/constants/providers/models.ts — helper functions and model metadata grouping
cli/src/state/atoms/ui.ts — added modelCatalog to InputMode enum/state
cli/src/state/atoms/keyboard.ts — keyboard handler additions to support catalog navigation
cli/src/state/hooks/useCommandContext.ts — added openModelCatalog to programmatically open the catalog
cli/src/commands/core/types.ts — added openModelCatalog to command context types
cli/src/ui/UI.tsx — integrated the catalog menu into the main CLI UI
cli/src/commands/model.ts — updated handler to open the catalog and emit deprecation warnings for old commands

Feature list

Shows all models from all providers, grouped by provider
Realtime search filtering as the user types
Pagination — 10 models per page
Sort options (preferred / name / context / price) — toggle with s
Capability filters (images / cache / reasoning / free) — toggle with f
Provider filter — cycle with p
Current model marked with a ⭐
Keyboard navigation:
- Arrow Up / Down — move selection
- Left / Right — change pages
- Enter — select model
- Esc — exit catalog
- s — sort options
- f — capability filters
- p — provider filter
Deprecation warnings for /model list and /model select that point users to the new interactive catalog

Notes and tradeoffs

This PR focuses on the CLI UX and the catalog data surface. It intentionally defers adding automated E2E tests for the interactive UI; manual test steps are included below. We can follow up with automated UI tests if desired.
Performance: catalog queries and model lists are in-memory from the provider metadata; if we later support remote model discovery, we should introduce incremental loading.
Accessibility: the component is keyboard-first; please review focus behavior and screen-reader labels.

Screenshots

before	after
(previous `/model list` output)	(interactive model catalog inside the CLI — searchable, paginated, grouped by provider)

(If you want, I can attach animated GIFs or terminal recording showing search, pagination and selection.)

How to Test

Run the CLI locally (from the repo root):
- Build/start whatever local dev flow you usually use for the cli package (e.g. run the CLI in dev mode or your local binary that executes the CLI UI).
Open the CLI and trigger the model command:
- Run the /model command in the CLI.
- Expect: the interactive model catalog opens (not the old flat list).
Verify basic interactions:
- Type a search query — the list should filter in realtime.
- Use Arrow Up/Down — selection moves between entries.
- Use Left/Right — pages change (10 models per page).
- Press Enter on a model — it should select that model (same effect as prior selection flow).
- Press Esc — the catalog should exit.
Verify filters and sort:
- Press s to cycle sort options (preferred / name / context / price) and observe that results reorder.
- Press f to toggle capability filters; check images/cache/reasoning/free flags filter results.
- Press p to cycle provider filter and confirm provider grouping filters to the selected provider.
Verify deprecation messages:
- Run /model list and /model select — confirm a clear deprecation warning is printed that points to the new /model interactive catalog.
Edge cases:
- Search for an unknown string — confirm empty state is displayed with an affordance to clear search.
- Verify that the current model (if set) is marked with a ⭐ in the listing.
- Verify behavior when models have missing metadata (should not crash).

If you want exact dev-run commands added to the README or the PR body (e.g., the pnpm command to boot the CLI dev mode), tell me which runner you use and I’ll add precise steps.

Get in Touch

If you have questions or want a demo recording, ping me on GitHub @Githubguy132010 or leave comments on this PR and I’ll respond. I’m also available in the Kilo Discord server as thomas07374 if you prefer a quick walkthrough.

Replaces /model list and /model select with an interactive, searchable, paginated model catalog interface. Features: - Shows all models from all providers, grouped by provider - Realtime search filtering as user types - Pagination (10 models per page) - Sort options (preferred/name/context/price) - press s - Capability filters (images/cache/reasoning/free) - press f - Provider filter - press p to cycle through providers - Current model marked with ⭐ - Keyboard navigation: ↑↓ navigate, ←→ pagination, Enter select, Esc exit - Deprecation warnings for /model list and /model select New files: - cli/src/types/modelCatalog.ts - Type definitions - cli/src/state/atoms/modelSelection.ts - State atoms for catalog mode - cli/src/ui/components/ModelCatalogMenu.tsx - UI component Modified: - cli/src/constants/providers/models.ts - Added helper functions - cli/src/state/atoms/ui.ts - Added modelCatalog to InputMode - cli/src/state/atoms/keyboard.ts - Added keyboard handler - cli/src/state/hooks/useCommandContext.ts - Added openModelCatalog - cli/src/commands/core/types.ts - Added openModelCatalog to context - cli/src/ui/UI.tsx - Integrated catalog menu - cli/src/commands/model.ts - Updated handler with deprecation warnings

changeset-bot · 2026-01-09T15:26:54Z

🦋 Changeset detected

Latest commit: efc9bfb

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@kilocode/cli	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

…ctions

… item display

…g artifacts

Ari4ka

marius-kilocode · 2026-01-13T07:50:02Z

I like where this is going @Githubguy132010! I have a few suggestions to get it even better for Kilo users:

-> In order to be consistent we want to show the same meta info in your new UI as in the standard `/model select `

Why the abbreviation ctx? Does context not fit?

marius-kilocode · 2026-01-13T07:50:42Z

I cannot search for models with letters s, f and p. Im not sure what would be the best way to solve this, but this would be a blocker.

marius-kilocode · 2026-01-13T07:50:54Z

I wonder if we can make the scrolling experience rather continuous. So that if users get to the bottom of the page automatically end up at the next model in the next way. But in such a way that my selected position does not jump here.

cli/src/state/atoms/modelSelection.ts

cli/src/state/atoms/keyboard.ts

cli/src/state/atoms/modelSelection.ts

cli/src/constants/providers/models.ts

Githubguy132010 · 2026-01-13T16:51:28Z

@marius-kilocode Review comments should now be adressed. I'm going to add tests later in a seperate commit. I will also look at the continuous scrolling idea later.

Githubguy132010 · 2026-01-13T17:45:12Z

I cannot search for models with letters s, f and p. Im not sure what would be the best way to solve this, but this would be a blocker.

Fixed in commit a5d0fad

Ari4ka

.

Githubguy132010 · 2026-01-16T10:36:35Z

.

@Ari4ka Could you explain what '.' means?

…catalog - Change navigation from page-based to item-based with a fixed visible window - Update selection logic to wrap around the entire list - Remove page atoms and keyboard handlers for left/right navigation - Add total items and window start atoms for UI display - Update tests and UI to reflect new scrolling behavior BREAKING CHANGE: Model catalog navigation now uses continuous scrolling instead of pagination, changing user interaction from page navigation to item-by-item with wrap-around.

Remove unused modelCatalogPageAtom, modelCatalogPageCountAtom, nextModelCatalogPageAtom, and prevModelCatalogPageAtom imports as part of replacing pagination with continuous scrolling.

Githubguy132010 · 2026-01-18T13:35:54Z

I wonder if we can make the scrolling experience rather continuous. So that if users get to the bottom of the page automatically end up at the next model in the next way. But in such a way that my selected position does not jump here.

@marius-kilocode Implemented virtual scrolling, but it's a breaking change. I removed the pagination for this to work, so that should be taken into consideration.

Githubguy132010 · 2026-01-30T15:48:11Z

Will close this due to CLI 1.0 launching soon.

AI Assistant and others added 3 commits January 9, 2026 15:31

Add changeset for interactive model catalog

17a0fcd

feat(model-catalog): implement model selection and update provider logic

c3a9c83

Merge branch 'main' into feature/interactive-model-catalog

53999bf

Ari4ka approved these changes Jan 11, 2026

View reviewed changes

Githubguy132010 added 6 commits January 11, 2026 10:01

Fix tests failing

866b6e0

Merge branch 'main' into feature/interactive-model-catalog

b00a86a

feat(model-catalog): fix keyboard navigation and update search instru…

5cc7ab0

…ctions

properly fix all issues

d7f4ff0

Fix "Search:" duplication

640de46

feat(model-catalog): update labels for sorting and filtering, enhance…

df5dc81

… item display

Githubguy132010 marked this pull request as ready for review January 11, 2026 13:08

Githubguy132010 requested a review from Ari4ka January 11, 2026 14:16

Thomas and others added 4 commits January 11, 2026 18:52

fix(model-catalog): remove terminal refresh calls to prevent renderin…

b580cfd

…g artifacts

fix(model-catalog): remove unused terminal refresh import

8163d73

Merge branch 'main' into feature/interactive-model-catalog

5bb2933

Merge branch 'main' into feature/interactive-model-catalog

7f9b71a

marius-kilocode added the CLI Kilo Code CLI label Jan 12, 2026

Merge branch 'main' into feature/interactive-model-catalog

1711947

Ari4ka reviewed Jan 13, 2026

View reviewed changes

marius-kilocode reviewed Jan 13, 2026

View reviewed changes

Githubguy132010 and others added 3 commits January 13, 2026 16:20

Merge branch 'main' into feature/interactive-model-catalog

15d0462

Merge branch 'main' into feature/interactive-model-catalog

ae61d60

Adress review comments

a5d0fad

Githubguy132010 requested a review from marius-kilocode January 13, 2026 16:51

Thomas added 2 commits January 13, 2026 18:10

Make Kilo code default starting provider

a394c65

Add unit tests

b2f3929

Githubguy132010 added 4 commits January 13, 2026 18:46

Merge branch 'main' into feature/interactive-model-catalog

685fbe9

Merge branch 'main' into feature/interactive-model-catalog

a55c840

Merge branch 'main' into feature/interactive-model-catalog

6f5cca7

Merge branch 'main' into feature/interactive-model-catalog

68bbd51

Ari4ka reviewed Jan 15, 2026

View reviewed changes

Merge branch 'main' into feature/interactive-model-catalog

45f511f

Githubguy132010 added 3 commits January 17, 2026 20:58

Merge branch 'main' into feature/interactive-model-catalog

d4ec417

refactor(cli): remove pagination atoms from imports

efc9bfb

Remove unused modelCatalogPageAtom, modelCatalogPageCountAtom, nextModelCatalogPageAtom, and prevModelCatalogPageAtom imports as part of replacing pagination with continuous scrolling.

Githubguy132010 closed this Jan 30, 2026

Githubguy132010 deleted the feature/interactive-model-catalog branch January 30, 2026 15:48

feat(cli): add interactive model catalog for /model command #4905

feat(cli): add interactive model catalog for /model command #4905

Uh oh!

Conversation

Githubguy132010 commented Jan 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Context

Implementation

Screenshots

How to Test

Get in Touch

Uh oh!

changeset-bot bot commented Jan 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

Ari4ka left a comment

Choose a reason for hiding this comment

Uh oh!

marius-kilocode commented Jan 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

marius-kilocode commented Jan 13, 2026

Uh oh!

marius-kilocode commented Jan 13, 2026

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Githubguy132010 commented Jan 13, 2026

Uh oh!

Githubguy132010 commented Jan 13, 2026

Uh oh!

Ari4ka left a comment

Choose a reason for hiding this comment

Uh oh!

Githubguy132010 commented Jan 16, 2026

Uh oh!

Githubguy132010 commented Jan 18, 2026

Uh oh!

Githubguy132010 commented Jan 30, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Githubguy132010 commented Jan 9, 2026 •

edited

Loading

changeset-bot bot commented Jan 9, 2026 •

edited

Loading

marius-kilocode commented Jan 13, 2026 •

edited

Loading