cli-providers

概要

CLI からプロバイダー接続を管理します：利用可能なプロバイダー／設定済みプロバイダーの一覧表示、追加、テスト、すべてのプロバイダーのテスト、検証、API キーのローテーション、プロバイダーごとのメトリクスの表示を行います。

クイックインストール

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

サブコマンド

provider-cmd provider [subcommand]

プロバイダー接続を管理します（次を使用します：

例：

omniroute provider-cmd provider [subcommand]

providers

例：

omniroute providers

providers available

OmniRoute カタログで利用可能なプロバイダーを表示します

フラグ：

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

例：

omniroute providers available

providers list

設定済みのプロバイダー接続を一覧表示します

フラグ：

• --json

例：

omniroute providers list

providers test <idOrName>

設定済みのプロバイダー接続をテストします

フラグ：

• --json

例：

omniroute providers test <idOrName>

providers test-all

有効なプロバイダー接続をすべてテストします

フラグ：

• --json

例：

omniroute providers test-all

providers validate

上流への呼び出しを行わずに、ローカルのプロバイダー設定を検証します

フラグ：

• --json

例：

omniroute providers validate

providers rotate <idOrName>

フラグ：

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

例：

omniroute providers rotate <idOrName>

providers status

フラグ：

• --provider <name>
• --json

例：

omniroute providers status

providers metrics

フラグ：

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

例：

omniroute providers metrics

providers metric <connectionId> <metric>

フラグ：

• --period <p>

例：

omniroute providers metric <connectionId> <metric>

test-provider test [provider] [model]

フラグ：

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

例：

omniroute test-provider test [provider] [model]

OmniRoute — CLI プロバイダーとキー

omniroute CLI が必要です。インストール方法とグローバルフラグについては、CLI エントリーポイントスキルを参照してください。

プロバイダーカタログ（利用可能なプロバイダー）

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

カテゴリ：api-key、oauth、free、local、combo。

設定済みプロバイダー接続

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

接続のテスト

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 は、接続ごとの成功／失敗をリアルタイムで表示する対話型 TUI を開きます。機械可読な結果を取得するには、--json を使用します：

omniroute providers test-all --json

API キー管理（OmniRoute キー）

これらは API Manager で発行された OmniRoute API キーを管理するもので、プロバイダーの認証情報ではありません。

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

キーポリシー

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

モデル

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 プロバイダー

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

Gemini、Windsurf、Antigravity などの OAuth プロバイダーでは、login コマンドを実行すると、ブラウザーで OmniRoute ダッシュボードの OAuth フローが開きます。

プロバイダーノード（複数アカウントのルーティング）

プロバイダーノードを使用すると、複数の API キー／アカウントを 1 つの論理プロバイダーに紐付け、ラウンドロビンまたはフェイルオーバーで利用できます。

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

ルーティングコンボ（CLI）

ターミナルからルーティングコンボを作成、管理します：

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

コンボの REST API 全体については、omni-combos-routing スキルを参照してください。

クォータと使用状況

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

圧縮（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 text

ヘルス

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

エラー

• providers test <id> が 401 で失敗する → そのプロバイダー用に保存されている API キーが正しくありません。keys remove と keys add を使用してリセットしてください
• oauth login を実行すると画面は開くものの完了しない → OAuth トークンエンドポイントがファイアウォールで遮断されている可能性があります。代わりに API キー認証を使用してください
• combo create が strategy unknown で失敗する → 次のいずれかを使用してください：priority、weighted、round-robin、fill-first、least-used、cost-optimized、auto、random、strict-random、p2c、reset-aware、lkgp、context-optimized、context-relay