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
npx skills add cheaper-inference/OmniRoute --skill cli-cost-usage -a claude-codeWhat 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 costand 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-code2Manually: put the files in place
~/.claude/skills/cli-cost-usage/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/cli-cost-usage/
1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill cli-cost-usage -a codex2Manually: put the files in place
.agents/skills/cli-cost-usage/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill cli-cost-usage -a cursor2Manually: put the files in place
.cursor/skills/cli-cost-usage/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install cheaper-inference/OmniRoute skills/cli-cost-usage2Manually: put the files in place
.github/skills/cli-cost-usage/SKILL.md1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill cli-cost-usage -a gemini-cli2Platform CLI
gemini skills install https://github.com/cheaper-inference/OmniRoute --path skills/cli-cost-usageManually: put the files in place
.devin/skills/cli-cost-usage/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill cli-cost-usage -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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