File contents ---
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.
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 AIRoute # or: npx AIRoute
AIRoute --version
Subcommands
costFlags:
--period <range>--since <date>--until <date>--group-by <field>--api-key <key>--limit <n>
Example:
AIRoute cost
pricingExample:
AIRoute pricing
pricing syncFlags:
Example:
AIRoute pricing sync
pricing listFlags:
--provider <p>--model <m>--limit <n>
Example:
AIRoute pricing list
pricing get <model>Example:
AIRoute pricing get <model>
pricing defaultsExample:
AIRoute pricing defaults
pricing showExample:
AIRoute pricing show
pricing setFlags:
--input <p>--output <p>--cache-read <p>--cache-write <p>
Example:
AIRoute pricing set
pricing diffFlags:
Example:
AIRoute pricing diff
usageExample:
AIRoute usage
usage analyticsFlags:
--period <range>--provider <id>
Example:
AIRoute usage analytics
usage budgetExample:
AIRoute usage budget
usage listExample:
AIRoute usage list
usage get [scope]Example:
AIRoute usage get [scope]
usage set <amount>Flags:
Example:
AIRoute usage set <amount>
usage reset [scope]Example:
AIRoute usage reset [scope]
usage quotaFlags:
Example:
AIRoute usage quota
usage logsFlags:
--limit <n>--search <q>--since <ts>--follow--api-key <k>
Example:
AIRoute usage logs
usage utilizationFlags:
Example:
AIRoute usage utilization
usage historyFlags:
Example:
AIRoute usage history
usage proxy-logsFlags:
Example:
AIRoute usage proxy-logs
1 --- 2 name: cli-cost-usage 3 description: --- 4 --- 5 --- 6 name: cli-cost-usage 7 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. 8 --- 9 <!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten --> 10 11 ## Overview 12 13 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. 14 15 ## Quick install 16 17 ```bash 18 npm install -g AIRoute # or: npx AIRoute 19 AIRoute --version 20 ``` 21 22 ## Subcommands 23 24 ### `cost` 25 26 **Flags:** 27 28 - `--period <range>` 29 - `--since <date>` 30 - `--until <date>` 31 - `--group-by <field>` 32 - `--api-key <key>` 33 - `--limit <n>` 34 35 **Example:** 36 37 ```bash 38 AIRoute cost 39 ``` 40 41 ### `pricing` 42 43 **Example:** 44 45 ```bash 46 AIRoute pricing 47 ``` 48 49 ### `pricing sync` 50 51 **Flags:** 52 53 - `--provider <p>` 54 - `--force` 55 56 **Example:** 57 58 ```bash 59 AIRoute pricing sync 60 ``` 61 62 ### `pricing list` 63 64 **Flags:** 65 66 - `--provider <p>` 67 - `--model <m>` 68 - `--limit <n>` 69 70 **Example:** 71 72 ```bash 73 AIRoute pricing list 74 ``` 75 76 ### `pricing get <model>` 77 78 **Example:** 79 80 ```bash 81 AIRoute pricing get <model> 82 ``` 83 84 ### `pricing defaults` 85 86 **Example:** 87 88 ```bash 89 AIRoute pricing defaults 90 ``` 91 92 ### `pricing show` 93 94 **Example:** 95 96 ```bash 97 AIRoute pricing show 98 ``` 99 100 ### `pricing set` 101 102 **Flags:** 103 104 - `--input <p>` 105 - `--output <p>` 106 - `--cache-read <p>` 107 - `--cache-write <p>` 108 109 **Example:** 110 111 ```bash 112 AIRoute pricing set 113 ``` 114 115 ### `pricing diff` 116 117 **Flags:** 118 119 - `--model <m>` 120 121 **Example:** 122 123 ```bash 124 AIRoute pricing diff 125 ``` 126 127 ### `usage` 128 129 **Example:** 130 131 ```bash 132 AIRoute usage 133 ``` 134 135 ### `usage analytics` 136 137 **Flags:** 138 139 - `--period <range>` 140 - `--provider <id>` 141 142 **Example:** 143 144 ```bash 145 AIRoute usage analytics 146 ``` 147 148 ### `usage budget` 149 150 **Example:** 151 152 ```bash 153 AIRoute usage budget 154 ``` 155 156 ### `usage list` 157 158 **Example:** 159 160 ```bash 161 AIRoute usage list 162 ``` 163 164 ### `usage get [scope]` 165 166 **Example:** 167 168 ```bash 169 AIRoute usage get [scope] 170 ``` 171 172 ### `usage set <amount>` 173 174 **Flags:** 175 176 - `--scope <s>` 177 - `--period <p>` 178 179 **Example:** 180 181 ```bash 182 AIRoute usage set <amount> 183 ``` 184 185 ### `usage reset [scope]` 186 187 **Example:** 188 189 ```bash 190 AIRoute usage reset [scope] 191 ``` 192 193 ### `usage quota` 194 195 **Flags:** 196 197 - `--provider <id>` 198 - `--check` 199 200 **Example:** 201 202 ```bash 203 AIRoute usage quota 204 ``` 205 206 ### `usage logs` 207 208 **Flags:** 209 210 - `--limit <n>` 211 - `--search <q>` 212 - `--since <ts>` 213 - `--follow` 214 - `--api-key <k>` 215 216 **Example:** 217 218 ```bash 219 AIRoute usage logs 220 ``` 221 222 ### `usage utilization` 223 224 **Flags:** 225 226 - `--api-key <k>` 227 228 **Example:** 229 230 ```bash 231 AIRoute usage utilization 232 ``` 233 234 ### `usage history` 235 236 **Flags:** 237 238 - `--limit <n>` 239 240 **Example:** 241 242 ```bash 243 AIRoute usage history 244 ``` 245 246 ### `usage proxy-logs` 247 248 **Flags:** 249 250 - `--limit <n>` 251 252 **Example:** 253 254 ```bash 255 AIRoute usage proxy-logs 256 ```
commit 76892f9f71
Frequently asked questions How do I install the CLI Cost Usage skill? Run npx skillmds@latest add jaccen/cli-cost-usage in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
What does the CLI Cost Usage skill do? --- It is listed under Coding & Dev Tools on SkillMD.
Is CLI Cost Usage safe to use? This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
Which AI agents work with CLI Cost Usage? This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Is CLI Cost Usage free to use? Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
Who published CLI Cost Usage? jaccen (@jaccen) published this skill. Their other Agent Skills are listed on their SkillMD profile.
jaccen