OpenModels CLI

Command-line interface for the OpenModels registry — browse models, compare providers, and check telemetry from your terminal.

Installation

# Install globally
npm install -g openmodels-cli

# Or run without installing
npx openmodels-cli

Requires Node.js ≥ 22.0.0.

Quick Start

# 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 anthropic

Commands

models list

List 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 |

models info <model-id>

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 json

providers list

List 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 <model-id>

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 |

search <query>

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 |

telemetry <provider-id>

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 |

completions <shell>

Generate shell completion scripts.

# Bash
openmodels completions bash >> ~/.bashrc

# Zsh
openmodels completions zsh > ~/.zfunc/_openmodels

# Fish
openmodels completions fish > ~/.config/fish/completions/openmodels.fish

Output Formats

All 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 output

JSON and YAML formats are designed for piping to other tools and CI/CD pipelines.

Configuration

Config File

Create ~/.openmodelsrc to store default settings:

{
  "api_url": "https://api.openmodels.run",
  "api_key": "om_...",
  "format": "table",
  "no_color": false
}

Environment Variables

| 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) |

Precedence

1. CLI flags (--api-url, --api-key, --format, --no-color)
2. Environment variables
3. Config file (~/.openmodelsrc)
4. Defaults

Global Options

| 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 |

What is OpenModels?

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.

Links

• Website: openmodels.run
• API: api.openmodels.run
• Registry: github.com/openmodelsrun/openmodels
• Docs: openmodels.run/docs

Development

git clone https://github.com/openmodelsrun/cli.git
cd cli
npm install
npm run build
npm test

License

MIT