CLI Cost Usage

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

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:

omniroute cost

pricing

Example:

omniroute pricing

pricing sync

Flags:

• --provider <p>
• --force

Example:

omniroute pricing sync

pricing list

Flags:

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

Example:

omniroute pricing list

pricing get <model>

Example:

omniroute pricing get <model>

pricing defaults

Example:

omniroute pricing defaults

pricing show

Example:

omniroute pricing show

pricing set

Flags:

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

Example:

omniroute pricing set

pricing diff

Flags:

• --model <m>

Example:

omniroute pricing diff

usage

Example:

omniroute usage

usage analytics

Flags:

• --period <range>
• --provider <id>

Example:

omniroute usage analytics

usage budget

Example:

omniroute usage budget

usage list

Example:

omniroute usage list

usage get [scope]

Example:

omniroute usage get [scope]

usage set <amount>

Flags:

• --scope <s>
• --period <p>

Example:

omniroute usage set <amount>

usage reset [scope]

Example:

omniroute usage reset [scope]

usage quota

Flags:

• --provider <id>
• --check

Example:

omniroute usage quota

usage logs

Flags:

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

Example:

omniroute usage logs

usage utilization

Flags:

• --api-key <k>

Example:

omniroute usage utilization

usage history

Flags:

• --limit <n>

Example:

omniroute usage history

usage proxy-logs

Flags:

• --limit <n>

Example:

omniroute usage proxy-logs