https://github.com/kud/models-dev-cli
https://github.com/kud/models-dev-cli
Last synced: 9 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/kud/models-dev-cli
- Owner: kud
- Created: 2025-09-05T21:21:25.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-09-05T23:33:55.000Z (10 months ago)
- Last Synced: 2025-09-06T01:16:12.170Z (10 months ago)
- Language: JavaScript
- Size: 15 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# models-dev CLI
Explore the models.dev catalogue from your terminal. Fast search, rich TUI, copy-to-clipboard.
[](https://www.npmjs.com/package/@kud/models-dev-cli)
---
## TL;DR
```bash
# one‑shot
npx -p @kud/models-dev-cli models-dev
# or install globally
npm i -g @kud/models-dev-cli
models-dev # alias: mdl
```
The CLI fetches the live catalogue and opens a split‑pane TUI by default. Prefer a non‑interactive table? Use flags (below) or `--ui table`.
## Preview
Interactive TUI – split‑pane with detailed model info, costs, limits and meta.
Provider picker (press p) to quickly filter the catalogue.
Model list with fuzzy search and color badges for capabilities.
Non‑interactive table mode with an actions prompt for filtering and paging.
## Highlights
- Blazing‑fast fuzzy search (Fuse) across name and id
- Filters for provider, tool‑calling, and reasoning
- Colorful split‑pane TUI with detail panel and copy‑ID
- Script‑friendly JSON and table output modes
- Safe terminal handling (works around Setulc/terminfo issues in iTerm2)
## Interactive TUI
Keybindings:
- `/`: search (fuzzy; blank clears)
- `p`: provider picker
- `t`: cycle tool filter (Any → Yes → No)
- `r`: cycle reasoning filter (Any → Yes → No)
- `s`: cycle sort (Default → Provider → Input $ → Output $ → Context)
- `c`: copy current model id to clipboard
- `h`: toggle the help/status bar
- `q`: quit
- Navigation: arrows or `j/k`, PageUp/PageDown scroll
Tips:
- The left list shows the provider in cyan and the model name in white.
- The detail panel groups info into Capabilities, Modalities, Costs, Limits and Meta, with color badges for quick scanning.
Force a mode:
```bash
MODELS_DEV_UI=blessed models-dev # force TUI
MODELS_DEV_UI=table models-dev # force table prompt mode
```
## Non‑Interactive Usage
```bash
models-dev --search claude
models-dev --provider openai --sort input-cost
models-dev --tool --reasoning
models-dev --provider anthropic --compact
models-dev --search grok --json
```
Flags:
- `--search `: substring match on name/id
- `--provider `: provider id or display name (case‑insensitive)
- `--tool`: only models with tool calling
- `--reasoning`: only models with reasoning capability
- `--sort `: one of `input-cost`, `output-cost`, `provider` (the TUI exposes additional sorts)
- `--json`: emit raw JSON for the resulting models
- `--compact`: print `provider:model:name:id` per line
- `--ui `: `blessed | table | auto` (default)
## Output Columns
Shown in both the non‑interactive table and the interactive list view when applicable:
- Provider, Model, Provider ID, Model ID
- Tool, Reason (reasoning capability)
- Modalities (input/output)
- Costs (input/output/cache read/cache write; per 1M tokens)
- Limits (context, output tokens)
- Temperature flag, Weight openness, Knowledge cutoff, Release, Updated
Missing numeric/cost fields render as `-`.
## Troubleshooting
Running in iTerm2 and seeing a Setulc/terminfo error? The CLI auto‑detects iTerm2/`xterm-256color` and avoids `tput`, which prevents the crash.
If you still hit issues:
```bash
# simplest workaround
TERM=xterm npx -p @kud/models-dev-cli models-dev
# fall back to table UI
models-dev --ui table
```
No color output desired? Set `NO_COLOR=1`.
## Development
```bash
git clone https://github.com/kud/models-dev-cli
cd models-dev-cli
npm install
npm link # exposes `models-dev` and `mdl`
models-dev # run locally
```
Code style notes:
- Keep changes minimal and focused
- Prefer small PRs with clear descriptions and screenshots/GIFs for UI changes
## License
MIT