Command-line interface for the OpenModels registry — browse models, compare providers, and check telemetry from your terminal.
# Install globally
npm install -g openmodels-cli
# Or run without installing
npx openmodels-cliRequires Node.js ≥ 22.0.0.
# List all models
openmodels models list
# Get details about a specific model
openmodels models info claude-opus-4-6
# Compare providers for a model
openmodels compare gpt-5
# Search models
openmodels search "code generation"# Check provider health
openmodels telemetry anthropicList models with optional filters.
openmodels models list
openmodels models list --capability reasoning
openmodels models list --modality text --sort context_window
openmodels models list --page 2 --limit 20| Option | Description |
|---|---|
--capability <cap> | Filter by capability (chat, completion, function-calling, code-generation, reasoning, vision, audio, embeddings, fine-tuning) |
--modality <mod> | Filter by modality (text, image, audio, video, code) |
--sort <field> | Sort by: name, recency, context_window, providers |
--page <n> | Page number |
--limit <n> | Results per page |
Display detailed information about a specific model including capabilities, modalities, context window, licensing, and provider availability with pricing.
openmodels models info claude-opus-4-6
openmodels models info deepseek-r1 --format jsonList inference providers.
openmodels providers list
openmodels providers list --search anthropic
openmodels providers list --page 1 --limit 10| Option | Description |
|---|---|
--search <term> | Filter providers by search term |
--page <n> | Page number |
--limit <n> | Results per page |
Compare all providers offering a specific model side-by-side, showing pricing, rate limits, and regions.
openmodels compare gpt-5
openmodels compare claude-opus-4-6 --sort rate_limit
openmodels compare deepseek-r1 --format yaml| Option | Description |
|---|---|
--sort <field> | Sort by: price (default), rate_limit |
Full-text search across models by name or description.
openmodels search "code generation"
openmodels search "vision" --capability chat --limit 5
openmodels search "reasoning"| Option | Description |
|---|---|
--capability <cap> | Additionally filter by capability |
--limit <n> | Maximum number of results |
View provider health status and latency metrics.
openmodels telemetry anthropic
openmodels telemetry together-ai --period 7d
openmodels telemetry openai --format json| Option | Description |
|---|---|
--period <period> | Time period: 1d, 7d, 30d |
Generate shell completion scripts.
# Bash
openmodels completions bash >>~/.bashrc
# Zsh
openmodels completions zsh >~/.zfunc/_openmodels
# Fish
openmodels completions fish >~/.config/fish/completions/openmodels.fishAll commands support the --format flag:
openmodels models list --format table # Default — colored, aligned columns
openmodels models list --format json # Machine-readable JSON
openmodels models list --format yaml # YAML outputJSON and YAML formats are designed for piping to other tools and CI/CD pipelines.
Create ~/.openmodelsrc to store default settings:
{
"api_url": "https://api.openmodels.run",
"api_key": "om_...",
"format": "table",
"no_color": false
}| Variable | Description |
|---|---|
OPENMODELS_API_URL | API base URL (default: https://api.openmodels.run) |
OPENMODELS_API_KEY | API authentication key |
NO_COLOR | Disable colored output (any value) |
- CLI flags (
--api-url,--api-key,--format,--no-color) - Environment variables
- Config file (
~/.openmodelsrc) - Defaults
| Flag | Description |
|---|---|
--format <type> | Output format: table, json, yaml |
--api-url <url> | API base URL |
--api-key <key> | API authentication key |
--no-color | Disable colored output |
--verbose | Show detailed error information |
-h, --help | Show help |
-V, --version | Show version |
OpenModels is an open-source, community-maintained registry of LLM models, inference providers, and provider-model mappings. It tracks 88+ models across 42+ providers with pricing, rate limits, and availability data.
- Website:openmodels.run
- API:api.openmodels.run
- Registry:github.com/openmodelsrun/openmodels
- Docs:openmodels.run/docs
git clone https://github.com/openmodelsrun/cli.git
cd cli
npm install
npm run build
npm testMIT