Skip to main content
ClaudeWave
Skill6.1k repo starsupdated today

cli-cost-usage

The cli-cost-usage skill provides command-line tools for monitoring API expenses and token consumption across multiple providers and models. Use it to view cost breakdowns, filter usage data by provider, model, or date range, manage budgets and quotas, inspect per-connection spending, and export usage reports and analytics from the terminal.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/diegosouzapw/OmniRoute /tmp/cli-cost-usage && cp -r /tmp/cli-cost-usage/skills/cli-cost-usage ~/.claude/skills/cli-cost-usage
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

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