Skip to main content
skill CX Codex

cli-cost-usage — Claude Code skill: usage and installation

The cli-cost-usage skill exposes CLI views for costs, token use, and call logs. Use it to inspect spending by provider, model, or date range.

MIT 1,300 installs ★ 89,427 updated 2026-11-11

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

What cli-cost-usage does

cli-cost-usage adds OmniRoute CLI commands for cost breakdowns, token usage, and call logs. The omniroute cost command accepts period and date filters, grouping, a result limit, and an API key. The usage commands cover analytics, budgets, quotas, history, and proxy logs.

The pricing group lets you sync, list, inspect, compare, and set model prices, including input, output, and cache values. omniroute usage logs supports search, limits, time filters, and following new entries. The CLI must be available first: install it with npm install -g omniroute or run it through npx. Without omniroute, the skill’s commands cannot run.

What it helps with

  • break down spending by provider or model
  • inspect token use for a selected period
  • search call logs for matching entries
  • sync and compare model pricing
  • check quotas and set usage budgets

Example prompts for the agent

  • Show spending with omniroute cost and group the result by provider.
  • Search the call logs for a selected period with omniroute usage logs.
  • Check model prices and sync them with omniroute pricing sync.

How to install cli-cost-usage

1Skills CLI (Vercel)

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

2Manually: put the files in place

~/.claude/skills/cli-cost-usage/SKILL.md

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

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about cli-cost-usage

How do I install cli-cost-usage in Claude Code?

Run npx skills add cheaper-inference/OmniRoute --skill cli-cost-usage -a claude-code, then check ~/.claude/skills/cli-cost-usage/SKILL.md.

What does cli-cost-usage do?

It provides OmniRoute commands for costs, token usage, quotas, budgets, and call logs. Filters cover providers, models, and time periods.

Which commands handle pricing and logs?

Pricing uses omniroute pricing, omniroute pricing sync, omniroute pricing list, and omniroute pricing get <model>, among other subcommands. Logs are available through omniroute usage logs and omniroute usage proxy-logs.

Source text

SKILL.md · MIT
---
name: cli-cost-usage
description: 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.
---

<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->

## Overview

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.

## Quick install

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

## Subcommands

### `cost`

**Flags:**

- `--period <range>`
- `--since <date>`
- `--until <date>`
- `--group-by <field>`
- `--api-key <key>`
- `--limit <n>`

**Example:**

```bash
omniroute cost
```

### `pricing`

**Example:**

```bash
omniroute pricing
```

### `pricing sync`

**Flags:**

- `--provider <p>`
- `--force`

**Example:**

```bash
omniroute pricing sync
```

### `pricing list`

**Flags:**

- `--provider <p>`
- `--model <m>`
- `--limit <n>`

**Example:**

```bash
omniroute pricing list
```

### `pricing get <model>`

**Example:**

```bash
omniroute pricing get <model>
```

### `pricing defaults`

**Example:**

```bash
omniroute pricing defaults
```

### `pricing show`

**Example:**

```bash
omniroute pricing show
```

### `pricing set`

**Flags:**

- `--input <p>`
- `--output <p>`
- `--cache-read <p>`
- `--cache-write <p>`

**Example:**

```bash
omniroute pricing set
```

### `pricing diff`

**Flags:**

- `--model <m>`

**Example:**

```bash
omniroute pricing diff
```

### `usage`

**Example:**

```bash
omniroute usage
```

### `usage analytics`

**Flags:**

- `--period <range>`
- `--provider <id>`

**Example:**

```bash
omniroute usage analytics
```

### `usage budget`

**Example:**

```bash
omniroute usage budget
```

### `usage list`

**Example:**

```bash
omniroute usage list
```

### `usage get [scope]`

**Example:**

```bash
omniroute usage get [scope]
```

### `usage set <amount>`

**Flags:**

- `--scope <s>`
- `--period <p>`

**Example:**

```bash
omniroute usage set <amount>
```

### `usage reset [scope]`

**Example:**

```bash
omniroute usage reset [scope]
```

### `usage quota`

**Flags:**

- `--provider <id>`
- `--check`

**Example:**

```bash
omniroute usage quota
```

### `usage logs`

**Flags:**

- `--limit <n>`
- `--search <q>`
- `--since <ts>`
- `--follow`
- `--api-key <k>`

**Example:**

```bash
omniroute usage logs
```

### `usage utilization`

**Flags:**

- `--api-key <k>`

**Example:**

```bash
omniroute usage utilization
```

### `usage history`

**Flags:**

- `--limit <n>`

**Example:**

```bash
omniroute usage history
```

### `usage proxy-logs`

**Flags:**

- `--limit <n>`

**Example:**

```bash
omniroute usage proxy-logs
```

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

Similar skills

SKILL.md skills catalog →

From the same set45

The whole set →
cli-mcp cli-mcp inspects MCP server status, triggers tools, manages scopes, and controls transports through the omniroute command-line interface. CX Codex +1 1,300installs config-codex-cli config-codex-cli is a Claude Code skill that configures Codex CLI through OmniRoute and checks the result. It detects the OS and shell. CX Codex +1 1,300installs omni-usage-logs omni-usage-logs — a skill that lets your agent query the OmniRoute usage API for call logs, token spend, latency and budget state across connections. CX Codex +1 1,300installs cli-health cli-health is a Claude Code skill that checks OmniRoute server health, component status, and metrics via the CLI. It tracks circuit breakers and provider availability in the terminal. CX Codex +1 1,300installs omni-compression omni-compression is a Claude Code skill that compresses prompts with RTK, Caveman, or both. It cuts API spend and speeds agent responses. CX Codex +1 1,300installs omni-settings omni-settings is a Claude Code skill for inspecting and updating OmniRoute settings, including system prompts, thinking budgets, IP filters, and proxy rules. CX Codex +1 1,300installs cli-keys cli-keys manages OmniRoute API keys and provider OAuth flows from your terminal. Handy when configuring model access and usage policies. CX Codex +1 1,300installs cli-models cli-models — a skill that lets the agent query the Anthropic model catalog from the command line: search, filter by provider, add and edit entries. CX Codex +1 1,300installs

Project sponsors

Companies that keep this analytics open