{"id":30920413,"url":"https://github.com/kud/models-dev-cli","last_synced_at":"2025-09-10T01:19:21.957Z","repository":{"id":313426415,"uuid":"1051362216","full_name":"kud/models-dev-cli","owner":"kud","description":null,"archived":false,"fork":false,"pushed_at":"2025-09-05T23:33:55.000Z","size":15756,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-06T01:16:12.170Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kud.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-05T21:21:25.000Z","updated_at":"2025-09-05T23:33:57.000Z","dependencies_parsed_at":"2025-09-06T01:16:16.012Z","dependency_job_id":"1b03699d-992f-4237-9f54-2aba03440198","html_url":"https://github.com/kud/models-dev-cli","commit_stats":null,"previous_names":["kud/models-dev-cli"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/kud/models-dev-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kud%2Fmodels-dev-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kud%2Fmodels-dev-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kud%2Fmodels-dev-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kud%2Fmodels-dev-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kud","download_url":"https://codeload.github.com/kud/models-dev-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kud%2Fmodels-dev-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274395846,"owners_count":25277387,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-09T02:00:10.223Z","response_time":80,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-09-10T01:19:19.527Z","updated_at":"2025-09-10T01:19:21.945Z","avatar_url":"https://github.com/kud.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# models-dev CLI\n\nExplore the models.dev catalogue from your terminal. Fast search, rich TUI, copy-to-clipboard.\n\n[![npm](https://img.shields.io/npm/v/%40kud%2Fmodels-dev-cli.svg?label=%40kud%2Fmodels-dev-cli)](https://www.npmjs.com/package/@kud/models-dev-cli)\n![node](https://img.shields.io/badge/node-%3E%3D18-3C873A)\n![license](https://img.shields.io/badge/license-MIT-blue)\n\n\u003c/div\u003e\n\n---\n\n## TL;DR\n\n```bash\n# one‑shot\nnpx -p @kud/models-dev-cli models-dev\n\n# or install globally\nnpm i -g @kud/models-dev-cli\nmodels-dev   # alias: mdl\n```\n\nThe CLI fetches the live catalogue and opens a split‑pane TUI by default. Prefer a non‑interactive table? Use flags (below) or `--ui table`.\n\n## Preview\n\n\u003c!-- Screenshots of the command in action --\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/preview-tui-details.png\" alt=\"Interactive TUI – details view\" width=\"900\" /\u003e\n  \u003cbr /\u003e\n  \u003cem\u003eInteractive TUI – split‑pane with detailed model info, costs, limits and meta.\u003c/em\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/preview-tui-provider-picker.png\" alt=\"Interactive TUI – provider picker\" width=\"900\" /\u003e\n  \u003cbr /\u003e\n  \u003cem\u003eProvider picker (press \u003ccode\u003ep\u003c/code\u003e) to quickly filter the catalogue.\u003c/em\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/preview-tui-list.png\" alt=\"Interactive TUI – model list\" width=\"900\" /\u003e\n  \u003cbr /\u003e\n  \u003cem\u003eModel list with fuzzy search and color badges for capabilities.\u003c/em\u003e\n\u003c/p\u003e\n\n\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/preview-table-mode.png\" alt=\"Non‑interactive table mode\" width=\"900\" /\u003e\n  \u003cbr /\u003e\n  \u003cem\u003eNon‑interactive table mode with an actions prompt for filtering and paging.\u003c/em\u003e\n\u003c/p\u003e\n\n## Highlights\n\n- Blazing‑fast fuzzy search (Fuse) across name and id\n- Filters for provider, tool‑calling, and reasoning\n- Colorful split‑pane TUI with detail panel and copy‑ID\n- Script‑friendly JSON and table output modes\n- Safe terminal handling (works around Setulc/terminfo issues in iTerm2)\n\n## Interactive TUI\n\nKeybindings:\n\n- `/`: search (fuzzy; blank clears)\n- `p`: provider picker\n- `t`: cycle tool filter (Any → Yes → No)\n- `r`: cycle reasoning filter (Any → Yes → No)\n- `s`: cycle sort (Default → Provider → Input $ → Output $ → Context)\n- `c`: copy current model id to clipboard\n- `h`: toggle the help/status bar\n- `q`: quit\n- Navigation: arrows or `j/k`, PageUp/PageDown scroll\n\nTips:\n\n- The left list shows the provider in cyan and the model name in white.\n- The detail panel groups info into Capabilities, Modalities, Costs, Limits and Meta, with color badges for quick scanning.\n\nForce a mode:\n\n```bash\nMODELS_DEV_UI=blessed models-dev     # force TUI\nMODELS_DEV_UI=table models-dev       # force table prompt mode\n```\n\n## Non‑Interactive Usage\n\n```bash\nmodels-dev --search claude\nmodels-dev --provider openai --sort input-cost\nmodels-dev --tool --reasoning\nmodels-dev --provider anthropic --compact\nmodels-dev --search grok --json\n```\n\nFlags:\n\n- `--search \u003cterm\u003e`: substring match on name/id\n- `--provider \u003cname\u003e`: provider id or display name (case‑insensitive)\n- `--tool`: only models with tool calling\n- `--reasoning`: only models with reasoning capability\n- `--sort \u003cfield\u003e`: one of `input-cost`, `output-cost`, `provider` (the TUI exposes additional sorts)\n- `--json`: emit raw JSON for the resulting models\n- `--compact`: print `provider:model:name:id` per line\n- `--ui \u003cmode\u003e`: `blessed | table | auto` (default)\n\n## Output Columns\n\nShown in both the non‑interactive table and the interactive list view when applicable:\n\n- Provider, Model, Provider ID, Model ID\n- Tool, Reason (reasoning capability)\n- Modalities (input/output)\n- Costs (input/output/cache read/cache write; per 1M tokens)\n- Limits (context, output tokens)\n- Temperature flag, Weight openness, Knowledge cutoff, Release, Updated\n\nMissing numeric/cost fields render as `-`.\n\n## Troubleshooting\n\nRunning in iTerm2 and seeing a Setulc/terminfo error? The CLI auto‑detects iTerm2/`xterm-256color` and avoids `tput`, which prevents the crash.\n\nIf you still hit issues:\n\n```bash\n# simplest workaround\nTERM=xterm npx -p @kud/models-dev-cli models-dev\n\n# fall back to table UI\nmodels-dev --ui table\n```\n\nNo color output desired? Set `NO_COLOR=1`.\n\n## Development\n\n```bash\ngit clone https://github.com/kud/models-dev-cli\ncd models-dev-cli\nnpm install\nnpm link           # exposes `models-dev` and `mdl`\nmodels-dev         # run locally\n```\n\nCode style notes:\n\n- Keep changes minimal and focused\n- Prefer small PRs with clear descriptions and screenshots/GIFs for UI changes\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkud%2Fmodels-dev-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkud%2Fmodels-dev-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkud%2Fmodels-dev-cli/lists"}