Como usar
- Copie o comando e verifique o pacote antes de instalar no seu ambiente de agente.
- Consulte no original as ferramentas, credenciais e ambientes necessários.
- 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-providersAntes 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.
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
npm install -g omniroute # or: npx omniroute
omniroute --versionSubcommands
provider-cmd provider [subcommand]
Manage provider connections (use
Example:
omniroute provider-cmd provider [subcommand]providers
Example:
omniroute providersproviders available
Show available providers in the OmniRoute catalog
Flags:
--json--search <query>-q, --q <query>--category <category>
Example:
omniroute providers availableproviders list
List configured provider connections
Flags:
--json
Example:
omniroute providers listproviders 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-allproviders validate
Validate local provider configuration without calling upstream
Flags:
--json
Example:
omniroute providers validateproviders 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 statusproviders metrics
Flags:
--provider <id>--connection-id <id>--period <p>--metric <m>--sort-by <field>--limit <n>--watch--compare <list>
Example:
omniroute providers metricsproviders 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 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 JSONCategories: api-key, oauth, free, local, combo.
Configured provider connections
omniroute providers list # Connections in your DB
omniroute providers list --jsonTesting 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 --jsonAPI 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 timesKey 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 keyModels
omniroute models # List all models (all providers)
omniroute models openai # Filter by provider
omniroute models --search gpt # Search by name
omniroute models --json # JSON outputOAuth 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 refreshFor 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.
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 nodeRouting combos (CLI)
Create and manage routing combos from the terminal:
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 comboFor the full REST API for combos see omni-combos-routing skill.
Quota & usage
omniroute quota # Provider quota usage + reset times
omniroute usage # Request + token usage summary
omniroute cost # Cost breakdown (by provider/model)Compression (CLI)
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 textHealth
omniroute health # Detailed health: circuit breakers, cache, memoryErrors
providers test <id>fails with 401 → API key stored for that provider is wrong; usekeys remove+keys addto reset itoauth loginopens but doesn't complete → the OAuth token endpoint may be firewalled; use API key auth insteadcombo createfails withstrategy 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 -->
