cli-cost-usage

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.

SKILL.md

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

npm install -g nextroute   # or: npx nextroute
nextroute --version

Subcommands

cost

Flags:

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

Example:

nextroute cost

pricing

Example:

nextroute pricing

pricing sync

Flags:

  • --provider <p>
  • --force

Example:

nextroute pricing sync

pricing list

Flags:

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

Example:

nextroute pricing list

pricing get <model>

Example:

nextroute pricing get <model>

pricing defaults

Example:

nextroute pricing defaults

pricing show

Example:

nextroute pricing show

pricing set

Flags:

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

Example:

nextroute pricing set

pricing diff

Flags:

  • --model <m>

Example:

nextroute pricing diff

usage

Example:

nextroute usage

usage analytics

Flags:

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

Example:

nextroute usage analytics

usage budget

Example:

nextroute usage budget

usage list

Example:

nextroute usage list

usage get [scope]

Example:

nextroute usage get [scope]

usage set <amount>

Flags:

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

Example:

nextroute usage set <amount>

usage reset [scope]

Example:

nextroute usage reset [scope]

usage quota

Flags:

  • --provider <id>
  • --check

Example:

nextroute usage quota

usage logs

Flags:

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

Example:

nextroute usage logs

usage utilization

Flags:

  • --api-key <k>

Example:

nextroute usage utilization

usage history

Flags:

  • --limit <n>

Example:

nextroute usage history

usage proxy-logs

Flags:

  • --limit <n>

Example:

nextroute usage proxy-logs