/cli-providers

name: cli-providers
description: "Manage provider connections from the CLI: list available/configured providers, add, test, test-all, validate, rotate API keys, and view per-provider metrics."

<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->

Overview

Manage provider connections from the CLI: list available/configured providers, add, test, test-all, validate, rotate API keys, and view per-provider metrics.

Quick install

npm install -g omniroute   # or: npx omniroute
omniroute --version

Subcommands

`provider-cmd provider [subcommand]`

Manage provider connections (use

**Example:**

omniroute provider-cmd provider [subcommand]

`providers`

**Example:**

omniroute providers

`providers available`

Show available providers in the OmniRoute catalog

**Flags:**

• `--json`
• `--search <query>`
• `-q, --q <query>`
• `--category <category>`

**Example:**

omniroute providers available

`providers list`

List configured provider connections

**Flags:**

• `--json`

**Example:**

omniroute providers list

`providers test <idOrName>`

Test a configured provider connection

**Flags:**

• `--json`

**Example:**

omniroute providers test <idOrName>

`providers test-all`

Test all active provider connections

**Flags:**

• `--json`

**Example:**

omniroute providers test-all

`providers validate`

Validate local provider configuration without calling upstream

**Flags:**

• `--json`

**Example:**

omniroute providers validate

`providers rotate <idOrName>`

**Flags:**

• `--new-key <key>`
• `--from-env <VAR>`
• `--oauth`
• `--yes`
• `--skip-test`
• `--dry-run`

**Example:**

omniroute providers rotate <idOrName>

`providers status`

**Flags:**

• `--provider <name>`
• `--json`

**Example:**

omniroute providers status

`providers metrics`

**Flags:**

• `--provider <id>`
• `--connection-id <id>`
• `--period <p>`
• `--metric <m>`
• `--sort-by <field>`
• `--limit <n>`
• `--watch`
• `--compare <list>`

**Example:**

omniroute providers metrics

`providers metric <connectionId> <metric>`

**Flags:**

• `--period <p>`

**Example:**

omniroute providers metric <connectionId> <metric>

`test-provider test [provider] [model]`

**Flags:**

• `--all-providers`
• `--json`
• `--latency`
• `--repeat <n>`
• `--compare <models>`
• `--save <path>`

**Example:**

omniroute test-provider test [provider] [model]

<!-- skill:custom-start --> <!-- Migrated from skills/omniroute-cli-providers/SKILL.md (preserved curated content) -->

OmniRoute — CLI Providers & Keys

Requires the `omniroute` CLI. See [CLI entry-point skill](https://raw.githubusercontent.com/diegosouzapw/OmniRoute/main/skills/cli-serve/SKILL.md) for install + global flags.

Provider catalog (available providers)

omniroute providers available                        # Full OmniRoute provider catalog
omniroute providers available --search openai        # Filter by id, name, alias
omniroute providers available --category api-key     # Filter by category
omniroute providers available --json                 # Machine-readable JSON

Categories: `api-key`, `oauth`, `free`, `local`, `combo`.

Configured provider connections

omniroute providers list                             # Connections in your DB
omniroute providers list --json

Testing connections

omniroute providers test <id|name>                   # Test one configured connection
omniroute providers test-all                         # Test every active connection (TUI progress)
omniroute providers validate                         # Local-only structural validation (no HTTP)

`test-all` opens an interactive TUI that shows live pass/fail per connection. Use `--json` to get a machine-readable result:

omniroute providers test-all --json

API key management (OmniRoute keys)

These manage the OmniRoute API keys issued under **API Manager** — not provider credentials.

omniroute keys list                                  # List all OmniRoute API keys
omniroute keys add <provider> [apiKey]               # Add an API key for a provider
omniroute keys remove <provider>                     # Remove an API key
omniroute keys regenerate <id>                       # Regenerate (rotate) a key
omniroute keys revoke <id>                           # Revoke a key (disables it)
omniroute keys reveal <id>                           # Show the full key value
omniroute keys usage <id>                            # Show usage stats for a key

omniroute keys rotate <id>                           # Rotate + revoke old key atomically
omniroute keys expiration list                       # List key expiration times

Key policies

omniroute keys policy show <id>                      # Show rate-limit / permission policy
omniroute keys policy set <id> \
  --rate-limit 100 \
  --rate-window minute \
  --permissions chat,models                          # Set policy on a key

Models

omniroute models                                     # List all models (all providers)
omniroute models openai                              # Filter by provider
omniroute models --search gpt                        # Search by name
omniroute models --json                              # JSON output

OAuth providers

omniroute oauth list                                 # List OAuth-configured providers
omniroute oauth login <provider>                     # Start browser-based OAuth flow
omniroute oauth logout <provider>                    # Revoke OAuth token
omniroute oauth status <provider>                    # Show token state + expiry
omniroute oauth refresh <provider>                   # Force token refresh

For OAuth providers (Gemini, Windsurf, Antigravity, etc.) the `login` c