Skip to main content
skill Claude Code CX Codex Cursor GitHub Copilot

cli-routing — Claude Code skill: what it does, how to install

Manage model routing combos from the command line with omniroute. Test routing strategies, inspect metrics, and configure fallback chains interactively.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add cheaper-inference/OmniRoute --skill cli-routing -a claude-code
Open on GitHub

What cli-routing does

The skill provides agent instructions to run omniroute CLI commands for model routing. It helps test routing strategies and switch active model combos directly in the terminal interface.

Under the hood, it interacts with several subcommands. The suggest command finds paths based on task descriptions, latency limits, and cost targets. Combos are managed with combo create, combo switch, combo delete, and listed via combo list with optional JSON formatting.

The skill depends on the external omniroute package, so you must install it globally with npm or execute it via npx. Without the CLI binary available in your environment, routing commands fail.

What it helps with

  • find optimal model routes with the suggest command
  • create custom model combos using combo create
  • switch active routing presets via combo switch
  • configure interactive fallback chains for model calls

Example prompts for the agent

  • Find a route for this task using `omniroute suggest --explain`.
  • Create a new combo with `omniroute combo create fast-path --models spec`.
  • List all configured routing combos in JSON using `omniroute combo list --json`.

How to install cli-routing

1Skills CLI (Vercel)

npx skills add cheaper-inference/OmniRoute --skill cli-routing -a claude-code

2Manually: put the files in place

~/.claude/skills/cli-routing/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/cli-routing/

From the same set34

The whole set →
cli-setup cheaper-inference Helps the agent configure OmniRoute, manage autostart, apply CLI updates, and adjust session environment variables. Claude Code CX Codex Cursor +1 1,200installs omni-combos-routing cheaper-inference This skill creates and manages model routing combos with fallback chains, tests, and metrics. Use it when OmniRoute needs configurable provider routing. Claude Code CX Codex Cursor +1 1,200installs omni-inference cheaper-inference Connects OpenAI-compatible inference endpoints for chat, embeddings, audio, and images. Useful for AI agents calling OmniRoute endpoints. Claude Code CX Codex Cursor +1 1,100installs cli-providers cheaper-inference Manage OmniRoute provider connections from the CLI: inspect the catalog, test connections, rotate keys, and view metrics. Useful when provider setup is part of your terminal workflow. Claude Code CX Codex Cursor +1 1,100installs omni-auth cheaper-inference Manage API keys and sessions in OmniRoute. Authenticates requests via Bearer tokens, handles dashboard login with password or OIDC, and controls session access. Claude Code CX Codex Cursor +1 1,100installs omni-mcp cheaper-inference Connects an agent to the OmniRoute MCP server for request routing, memory, cache, and audit work. Use it when those operations need to be available as MCP tools. Claude Code CX Codex Cursor +1 1,100installs omni-providers cheaper-inference Manages connections to 375 AI providers via REST API: adds keys, tests connections, syncs models. Claude Code CX Codex Cursor +1 1,100installs cli-keys cheaper-inference Manages OmniRoute API keys and provider OAuth flows from your terminal. Handy when configuring model access and usage policies. Claude Code CX Codex Cursor +1 1,000installs

Similar

video-toolkit calesthio Automates video creation: generates voiceovers, background music, animates talking heads, and composes scenes with Remotion. Requires Node.js, Python3, ffmpeg, and cloud GPU access (Modal or RunPod). Claude Code CX Codex Cursor +1 1,100installs text-to-speech calesthio Generates speech audio with HeyGen Starfish and lets you choose a voice, speed, and pitch. Useful for voiceovers, narration, and podcasts. Claude Code CX Codex Cursor +1 1,100installs ascii-video SHL0MS, Hermes Agent Converts video, audio, and images into colored ASCII video (MP4, GIF). Supports audio-reactive visualization, generative animation, and text overlays. Claude Code CX Codex Cursor +1 435installs frontend-dev MiniMax-AI Orchestrates frontend development, motion design, AI-generated media, and conversion copy. Built for landing pages, marketing sites, and dashboards. Claude Code CX Codex Cursor +1 3,200installs microsoft-agent-framework official github Guides GitHub Copilot through building, updating, reviewing, and explaining Microsoft Agent Framework applications. It also covers migrations from Semantic Kernel and AutoGen. GitHub Copilot 1,900installs bfl-api Black Forest Labs This skill helps connect BFL FLUX API for image generation and editing. It covers async requests, polling, rate limits, and webhooks. Claude Code CX Codex Cursor +1 1,000installs skill-creator official anthropics Creates and refines skills, then tests them with prompts, evaluations, and performance checks. Claude Code Claude.ai 414,180installs writing-for-agents Matt Pocock Guidance for writing skills and agent-facing documents. Use it when editing AGENTS.md, CLAUDE.md, or reference files reached from them. Claude Code 466,719installs

Questions about cli-routing

How to install cli-routing in Claude Code?

Run npx skills add cheaper-inference/OmniRoute --skill cli-routing -a claude-code in your terminal to install the skill.

What does cli-routing do?

It lets your agent configure model routing combos, test routing rules, inspect metrics, and switch active chains from the command line.

What is required before using cli-routing?

You need the omniroute package installed globally via npm install -g omniroute or accessible through npx omniroute.

Source text

SKILL.md · MIT
---
name: cli-routing
description: Create, list, update, and delete routing combos from the CLI. Test routing strategies, inspect combo metrics, and configure fallback chains interactively.
---
<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->

## Overview

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

## Quick install

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

## Subcommands

### `suggest`

**Flags:**

- `--task <description>`
- `--max-cost <usd>`
- `--max-latency-ms <ms>`
- `--weights <json>`
- `--top <n>`
- `--explain`
- `--switch`

**Example:**

```bash
omniroute suggest
```

### `combo combo`

**Example:**

```bash
omniroute combo combo
```

### `combo list`

List configured routing combos

**Flags:**

- `--json`

**Example:**

```bash
omniroute combo list
```

### `combo switch <name>`

Activate a routing combo

**Example:**

```bash
omniroute combo switch <name>
```

### `combo create <name>`

Create a new routing combo

**Flags:**

- `--models <spec>`
- `--model <spec>`

**Example:**

```bash
omniroute combo create <name>
```

### `combo delete <name>`

Delete a routing combo

**Flags:**

- `--yes`

**Example:**

```bash
omniroute combo delete <name>
```

© cheaper-inference · MIT · cheaper-inference/OmniRoute

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor