Agent skill

OmniRoute Cost and Usage CLI

by diegosouzapw in diegosouzapw/OmniRoute

“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.”

— description from SKILL.md by diegosouzapw
MITAuto-check passedAI & LLM Engineering

Install OmniRoute Cost and Usage CLI

skills CLI
$ npx skills add diegosouzapw/OmniRoute --skill cli-cost-usage -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install diegosouzapw/OmniRoute cli-cost-usage --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/diegosouzapw/OmniRoute.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/cli-cost-usage .claude/skills/cli-cost-usage && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
cli-cost-usage
GitHub stars
74k
Token cost
~693 tokens
SKILL.md length
162 words
Files
1
Skills in repo
50
Repo updated
First seen
Licence
MIT

At a glance

  • SKILL.md covers Overview, Quick install and Subcommands
  • Calls npm

About this skill

OmniRoute Cost and Usage CLI is a skill in diegosouzapw/OmniRoute (74k stars). Its SKILL.md is about 693 tokens. Licence: MIT.

What it can do on your machine

Read from SKILL.md and the folder at commit 8ad6b1c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

OmniRoute Cost and Usage CLI loads about 693 tokens when it runs. Until then it costs about 44 tokens; SKILL.md has 162 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~44
When it runs · the whole SKILL.md, loaded when a task matches
~693

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from diegosouzapw/OmniRoute at commit 8ad6b1c, republished under its MIT licence (© diegosouzapw). 162 words, ~693 tokens.

Download SKILL.mdSave it as .claude/skills/cli-cost-usage/SKILL.md (or your agent's skills folder).
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

© diegosouzapw, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/cli-cost-usage of diegosouzapw/OmniRoute.

Open the folder on GitHubat commit 8ad6b1c

Compare with similar skills

OmniRoute Cost and Usage CLI next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

OmniRoute Cost and Usage CLI compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
OmniRoute Cost and Usage CLI this skilldiegosouzapw/OmniRoute74k—~693Automated safety check: PassMIT
AI Observabilityomer-metin/skills-for-antigravity162—~578Automated safety check: PassApache-2.0
Caveman Workflow LabelerJuliusBrussee/caveman110k1 repos~1.3kAutomated safety check: PassApache-2.0
Caveman Evidence ReviewJuliusBrussee/caveman110k1 repos~927Automated safety check: PassApache-2.0
CodexBar Usage Readersteipete/CodexBar22k—~320Automated safety check: PassMIT
FreeRide Free Model ManagerShaivpidadi/FreeRide2383 repos~1.1kAutomated safety check: PassNone

Similar skills

  • AI Observability

    omer-metin/skills-for-antigravity

    Implement comprehensive observability for LLM applications including tracing (Langfuse/Helicone), cost tracking, token optimization, RAG evaluation metrics (RAGAS), hallucination detection, and…

    162 GitHub stars~578 tokensUpdated 8 mo ago
    AI & LLM EngineeringAuto-check passed
  • Caveman Workflow Labeler

    JuliusBrussee/caveman

    Finds every LLM workflow in a repository, proposes a labeling table and, once you agree, wires labels so Caveman Cloud groups spend per workflow.

    110k GitHub starsUsed in 1 repo~1.3k tokens
    AI & LLM EngineeringAuto-check passed
  • Caveman Evidence Review

    JuliusBrussee/caveman

    Read-only review of Caveman Cloud data to explain where LLM spend goes: cost, score, workflows, traces, latency, errors, routing and verified savings.

    110k GitHub starsUsed in 1 repo~927 tokens
    AI & LLM EngineeringAuto-check passed
  • CodexBar Usage Reader

    steipete/CodexBar

    CodexBar read. Provider usage, limits, credits, config health. JSON. No writes.

    22k GitHub stars~320 tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • FreeRide Free Model Manager

    Shaivpidadi/FreeRide

    Configures OpenClaw to use free OpenRouter models, setting the best one as primary and adding ranked fallbacks so rate limits do not interrupt work.

    238 GitHub starsUsed in 3 repos~1.1k tokens
    AI & LLM EngineeringAuto-check passed
  • Caveman Gateway Setup

    JuliusBrussee/caveman

    Routes every LLM call in a repository through the Caveman Cloud gateway in record mode, so requests and costs are measured without changing behavior.

    110k GitHub starsUsed in 1 repo~2.6k tokens
    DevOps & CloudAuto-check: warnings

More from diegosouzapw/OmniRoute

All 50 skills in this repo
  • OmniRoute Backup and Sync CLI

    diegosouzapw/OmniRoute

    Backup and restore OmniRoute data from the CLI. Trigger incremental snapshots, sync to cloud storage, manage backup schedules, and restore from archive files.

    74k GitHub stars~948 tokensUpdated yesterday
    Auto-check passed
  • OmniRoute Settings API

    diegosouzapw/OmniRoute

    Read and update global application settings: system prompts, thinking budget, IP filters, payload rules, combo defaults, and require-login configuration.

    74k GitHub starsUsed in 1 repo~3.6k tokens
    Auto-check passed
  • Quality Scan

    diegosouzapw/OmniRoute

    Runs a scoped, read-only quality scan on a repository candidate and reports exact evidence, failures and frozen debt, without treating a static scan as release acceptance.

    74k GitHub stars~748 tokensUpdated yesterday
    Auto-check passed
  • OmniRoute Database Backups

    diegosouzapw/OmniRoute

    Trigger system backups, restore from backup files, and manage the SQLite database lifecycle. Supports export, import, and incremental snapshot strategies.

    74k GitHub starsUsed in 1 repo~395 tokens
    Auto-check passed
  • OmniRoute Provider Management

    diegosouzapw/OmniRoute

    Manages AI provider connections, API keys, OAuth flows and connection tests through OmniRoute's REST API across its 327-provider catalog.

    74k GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed
  • OmniRoute LLM Cache

    diegosouzapw/OmniRoute

    Documents OmniRoute's cache endpoints for reading cache statistics and clearing entries, statistics or the reasoning cache, with notes on TTL and similarity settings.

    74k GitHub starsUsed in 1 repo~529 tokens
    Auto-check passed

Works with

Questions about OmniRoute Cost and Usage CLI

How do I install OmniRoute Cost and Usage CLI in Claude Code?

Run `npx skills add diegosouzapw/OmniRoute --skill cli-cost-usage -a claude-code`. Or copy the skill folder (skills/cli-cost-usage in diegosouzapw/OmniRoute) into .claude/skills/cli-cost-usage in your project. Claude Code loads it when a task matches its description.

How do I install OmniRoute Cost and Usage CLI in Codex?

Run `npx skills add diegosouzapw/OmniRoute --skill cli-cost-usage -a codex`. Or copy the skill folder (skills/cli-cost-usage in diegosouzapw/OmniRoute) into .agents/skills/cli-cost-usage in your project. Codex loads it when a task matches its description.

Can I use OmniRoute Cost and Usage CLI in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add diegosouzapw/OmniRoute --skill cli-cost-usage -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cli-cost-usage, .gemini/skills/cli-cost-usage, .github/skills/cli-cost-usage and .opencode/skills/cli-cost-usage in your project.

What does OmniRoute Cost and Usage CLI need to run?

Going by SKILL.md and its folder, OmniRoute Cost and Usage CLI needs the command-line tools its instructions call (npm).

Does OmniRoute Cost and Usage CLI access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is OmniRoute Cost and Usage CLI safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does OmniRoute Cost and Usage CLI use?

OmniRoute Cost and Usage CLI is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does OmniRoute Cost and Usage CLI use?

About 693 tokens (SKILL.md is roughly 2.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to OmniRoute Cost and Usage CLI?

Skills that share tags, products or a category with OmniRoute Cost and Usage CLI: AI Observability (omer-metin/skills-for-antigravity, 162 stars), Caveman Workflow Labeler (JuliusBrussee/caveman, 110k stars), Caveman Evidence Review (JuliusBrussee/caveman, 110k stars) and CodexBar Usage Reader (steipete/CodexBar, 22k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains OmniRoute Cost and Usage CLI?

diegosouzapw (a GitHub user) maintains it in diegosouzapw/OmniRoute, which has 73,701 GitHub stars. The repository holds 50 skills in this directory. The repository was last updated on October 6, 2026.

Source: diegosouzapw/OmniRoute on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.