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.
Savant verdict: Review advised
Security analysis or source-hub review identified patterns requiring attention.
Live evaluation
Not evaluated yet. Workspaces can request a live evaluation.
Security assessment
Scan pending.
Structure
- No license declaredConfirm you may reuse this skill before importing it into your repository.
- The source hub's security checks flagged this skillGen Agent Trust Hub: warn (This skill provides a command-line interface manual for managing API providers and credentials. It includes capabilities to reveal and manage sensitive API keys, which could lead to unauthorized data exposure if executed by an agent without oversight.)
SKILL.md
--- 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 ```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](https://raw.githubusercontent.com/diegosouzapw/OmniRoute/main/skills/omniroute-cli/SKILL.md) 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 [omniroute-routing skill](https://raw.githubusercontent.com/diegosouzapw/OmniRoute/main/skills/omniroute-routing/SKILL.md). ## 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 -->