MCPInstall

cli-providers

by cheaper-inferenceTesting & QA

Manage provider connections from the CLI: list available/configured providers, add, test, test-all, validate, rotate API keys, and view per-provider metrics.

Installs
1.1K
Last 24h
+23
Trending rank
#5128
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/cheaper-inference/omniroute --skill cli-providers
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads cli-providers automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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

Subcommands

provider-cmd provider [subcommand]

Manage provider connections (use

Example:

omniroute provider-cmd provider [subcommand]

providers

Example:

omniroute providers

providers available

Show available providers in the OmniRoute catalog

Flags:

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

Example:

omniroute providers available

providers list

List configured provider connections

Flags:

  • --json

Example:

omniroute providers list

providers 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-all

providers validate

Validate local provider configuration without calling upstream

Flags:

  • --json

Example:

omniroute providers validate

providers 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 status

providers metrics

Flags:

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

Example:

omniroute providers metrics

providers 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 JSON

Categories: api-key, oauth, free, local, combo.

Configured provider connections

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

Testing 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 --json

API 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 times

Key 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 key

Models

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

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.

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:

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

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 text

Health

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

FAQ

What does the cli-providers skill do?

Manage provider connections from the CLI: list available/configured providers, add, test, test-all, validate, rotate API keys, and view per-provider metrics.

How do I install cli-providers?

Run npx skills add https://github.com/cheaper-inference/omniroute --skill cli-providers in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/cli-providers/ (personal) or .claude/skills/cli-providers/ (project).

Which AI agents can use cli-providers?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is cli-providers safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains cli-providers?

It is published by cheaper-inference in cheaper-inference/omniroute. It has 1,105 recorded installs.

More from cheaper-inference/omniroute

View all →

omni-combos-routing

cheaper-inference/omniroute

Create and manage routing combos with 19 strategies (priority, weighted, round-robin, Auto-combo, and more). Configure fallback chains, test routing outcomes, and retrieve combo metrics.

AI & Agents1.3K installs

cli-setup

cheaper-inference/omniroute

Run initial setup, configure global CLI settings, manage environment variables, check for updates, and configure autostart via the CLI setup and config commands.

AI & Agents1.2K installs

omni-providers

cheaper-inference/omniroute

Manage provider connections, API keys, OAuth flows, and connection tests via the REST API. List, add, update, remove, and test AI provider integrations across OmniRoute's 375-provider catalog.

Backend & APIs1.1K installs

omni-mcp

cheaper-inference/omniroute

Connect to the OmniRoute MCP server (110 tools, 3 transports: SSE/stdio/HTTP). Covers routing, cache, compression, memory, skills, providers, and audit tools across 33 permission scopes.

AI & Agents1.1K installs

cli-routing

cheaper-inference/omniroute

Create, list, update, and delete routing combos from the CLI. Test routing strategies, inspect combo metrics, and configure fallback chains interactively.

AI & Agents1.1K installs

omni-auth

cheaper-inference/omniroute

Manage API key authentication and session tokens. Start here to authenticate requests via Bearer token, obtain session cookies, and configure login requirements for the OmniRoute API.

Backend & APIs1.1K installs

Popular testing & qa skills

View category →

tdd

mattpocock/skills

Test-driven development. Use when the user wants to build features or fix bugs test-first, mentions "red-green-refactor", or wants integration tests.

Testing & QA1.2M installs

grilling

mattpocock/skills

Grill the user relentlessly about a plan, decision, or idea. Use when the user wants to stress-test their thinking, or uses any 'grill' trigger phrases.

Testing & QA996.2K installs

migrate-to-shoehorn

mattpocock/skills

Migrate test files from as type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace as in tests, or needs partial test data.

Testing & QA484.1K installs

run-train

lllllllama/rigorpilot-skills

Rigor Train skill for deep learning research repositories. Use when a documented or selected training command should be run conservatively for startup verification, short-run verification, full kickoff, or resume, with command, config, seed, log, checkpoint, status, and metric evidence written to standardized trainoutputs/. Do not use for environment setup, exploratory sweeps, speculative idea implementation, or end-to-end orchestration.

Testing & QA337.8K installs

test-driven-development

obra/superpowers

Use when implementing any feature or bugfix, before writing implementation code

Testing & QA261.8K installs

finishing-a-development-branch

obra/superpowers

Use when implementation is complete, all tests pass, and you need to decide how to integrate the work

Testing & QA216.8K installs