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.

ソースを見る

使い方

  1. インストールコマンドをコピーし、自分の環境へ導入する前にソースを確認します。
  2. 必要なツール、認証情報、対応環境を原文で確認します。
  3. 入力と成果物を指定し、出力を資料と照合します。
npx skills add https://github.com/cheaper-inference/omniroute --skill cli-providers

開始前の確認

  • 導入にはモデル契約、API枠、ファイルへのアクセス許可は含まれません。
  • スター数や導入数は活動の指標であり、独立した品質・安全性試験ではありません。
リポジトリの原文

見出し、例、コード、表、リンク、参照画像を含む原文を表示しています。

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

同じリポジトリから

関連する Skills

すべての Skills
cheaper-inference
コミュニティ

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.

1時間の導入数
1
GitHub Stars
8.8万
更新日
11月17日
cheaper-inference
コミュニティ

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.

1時間の導入数
1
GitHub Stars
8.8万
更新日
11月17日
cheaper-inference
コミュニティ

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.

1時間の導入数
1
GitHub Stars
8.8万
更新日
11月17日
cheaper-inference
コミュニティ

omni-webhooks

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

1時間の導入数
1
GitHub Stars
8.8万
更新日
11月17日