cheaper-inference/omniroute

cli-providers

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

Ver código-fonte

Como usar

  1. Copie o comando e verifique o pacote antes de instalar no seu ambiente de agente.
  2. Consulte no original as ferramentas, credenciais e ambientes necessários.
  3. Descreva os dados de entrada e a entrega esperada; confira a saída com as fontes.
npx skills add https://github.com/cheaper-inference/omniroute --skill cli-providers

Antes de começar

  • A instalação não inclui assinatura de modelo, franquia API ou acesso aos seus arquivos.
  • Estrelas e instalações indicam atividade, não um teste independente de qualidade ou segurança.
Documento original do Skill

Renderizado do repositório de origem, preservando títulos, exemplos, código, tabelas, links e imagens.

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

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

Subcommands

provider-cmd provider [subcommand]

Manage provider connections (use

Example:

bash
omniroute provider-cmd provider [subcommand]

providers

Example:

bash
omniroute providers

providers available

Show available providers in the OmniRoute catalog

Flags:

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

Example:

bash
omniroute providers available

providers list

List configured provider connections

Flags:

  • --json

Example:

bash
omniroute providers list

providers test <idOrName>

Test a configured provider connection

Flags:

  • --json

Example:

bash
omniroute providers test <idOrName>

providers test-all

Test all active provider connections

Flags:

  • --json

Example:

bash
omniroute providers test-all

providers validate

Validate local provider configuration without calling upstream

Flags:

  • --json

Example:

bash
omniroute providers validate

providers rotate <idOrName>

Flags:

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

Example:

bash
omniroute providers rotate <idOrName>

providers status

Flags:

  • --provider <name>
  • --json

Example:

bash
omniroute providers status

providers metrics

Flags:

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

Example:

bash
omniroute providers metrics

providers metric <connectionId> <metric>

Flags:

  • --period <p>

Example:

bash
omniroute providers metric <connectionId> <metric>

test-provider test [provider] [model]

Flags:

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

Example:

bash
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 for install + global flags.

Provider catalog (available providers)

bash
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

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

Testing connections

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

bash
omniroute providers test-all --json

API key management (OmniRoute keys)

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

bash
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

bash
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

bash
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

bash
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 command opens the OmniRoute dashboard OAuth flow in your browser.

Provider nodes (multi-account routing)

Provider nodes let you attach multiple API keys / accounts to one logical provider for round-robin or failover.

bash
omniroute nodes list <provider>                      # List nodes for a provider
omniroute nodes add <provider> --api-key <key>       # Add a node
omniroute nodes remove <provider> <nodeId>           # Remove a node
omniroute nodes test <provider> <nodeId>             # Test one node

Routing combos (CLI)

Create and manage routing combos from the terminal:

bash
omniroute combo list                                 # List all combos
omniroute combo create <name> \
  --strategy priority \
  --targets anthropic/claude-opus-4-7,openai/gpt-4o  # Create combo
omniroute combo switch <name>                        # Activate a combo as default
omniroute combo delete <name>                        # Delete a combo
omniroute combo suggest --task "code review"         # Ask OmniRoute to recommend a combo

For the full REST API for combos see omni-combos-routing skill.

Quota & usage

bash
omniroute quota                                      # Provider quota usage + reset times
omniroute usage                                      # Request + token usage summary
omniroute cost                                       # Cost breakdown (by provider/model)

Compression (CLI)

bash
omniroute compression status                         # Current compression mode + savings stats
omniroute compression set --mode rtk                 # Enable RTK compression
omniroute compression set --mode stacked             # Enable stacked (RTK + Caveman)
omniroute compression set --mode off                 # Disable compression
omniroute compression preview --mode rtk --text "..."  # Preview savings for sample text

Health

bash
omniroute health                                     # Detailed health: circuit breakers, cache, memory

Errors

  • providers test <id> fails with 401 → API key stored for that provider is wrong; use keys remove + keys add to reset it
  • oauth login opens but doesn't complete → the OAuth token endpoint may be firewalled; use API key auth instead
  • combo create fails with strategy unknown → use one of: priority, weighted, round-robin, fill-first, least-used, cost-optimized, auto, random, strict-random, p2c, reset-aware, lkgp, context-optimized, context-relay

<!-- skill:custom-end -->

do mesmo repositório

Mais Skills

Todos os Skills
cheaper-inference
Comunidade

cli-chat

Send chat completions, stream responses, and start an interactive REPL session from the CLI. Supports all OmniRoute providers, combo routing, and system prompt configuration.

Instalações / 1h
1
GitHub Stars
88,1 mil
Atualizado
17 de nov.
cheaper-inference
Comunidade

cli-health

Check server health, component status, and live metrics from the CLI. Run health, health components, and health watch for a real-time dashboard of circuit breakers and provider status.

Instalações / 1h
1
GitHub Stars
88,1 mil
Atualizado
17 de nov.
cheaper-inference
Comunidade

omni-github-skills

Search, score, scan, and import agent skills from GitHub repositories that contain SKILL.md, CLAUDE.md, .cursorrules, and similar agent skill files. Discover community skills across many tool and provider categories, evaluate relevance with heuristic scoring, check for malware or hardcoded secrets, and install into Hermes, Claude Code, Gemini CLI, or OpenCode agent directories.

Instalações / 1h
1
GitHub Stars
88,1 mil
Atualizado
17 de nov.
cheaper-inference
Comunidade

omni-webhooks

Register, list, test, and remove webhook endpoints. Configure event subscriptions (request.completed, request.failed, quota.exceeded, etc.) and manage delivery retries.

Instalações / 1h
1
GitHub Stars
88,1 mil
Atualizado
17 de nov.