cli-providers
The cli-providers skill enables command-line management of AI provider connections in OmniRoute, supporting operations to list available and configured providers, add new connections, test individual or all providers, validate configurations, rotate API keys, and monitor per-provider performance metrics. Use this skill when setting up provider integrations, diagnosing connection issues, maintaining API credentials, or analyzing provider performance data from the terminal.
git clone --depth 1 https://github.com/diegosouzapw/OmniRoute /tmp/cli-providers && cp -r /tmp/cli-providers/skills/cli-providers ~/.claude/skills/cli-providersSKILL.md
<!-- 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 ro
Interact with the OmniRoute A2A server from the CLI. Send tasks, inspect skill execution history, and test the JSON-RPC 2.0 agent-to-agent protocol interactively.
Backup and restore OmniRoute data from the CLI. Trigger incremental snapshots, sync to cloud storage, manage backup schedules, and restore from archive files.
Submit and monitor batch inference jobs from the CLI. Upload and manage files for batch processing, retrieve results, and integrate batch pipelines with CI/CD workflows.
Send chat completions, stream responses, and start an interactive REPL session from the CLI. Supports all OmniRoute providers, combo routing, and system prompt configuration.
Configure and test prompt compression from the CLI. Manage RTK filters, Caveman rules, stacked compression modes, and preview compression output with real prompts.
Manage context engineering configurations, RTK filter sets, and conversation sessions from the CLI. Apply context-relay settings and inspect active context pipelines.
View cost breakdowns, token usage, and call logs from the CLI. Filter by provider, model, or date range. Export usage reports and inspect per-connection spending.
Create and run evaluation suites, watch live benchmark progress, view scorecards, compare model performance, and integrate eval runs with CI workflows from the CLI.