otty / apps
All apps/CodeBurn

CodeBurn

codeburn
Runs as codeburn|macOS, Linux, Windows|codeburn.app
Open form in Otty otty.toml

Command form

ai-draft · 2 tasks · 7 fields

Print a usage and cost report for AI coding tools over a period or date range, optionally as JSON. The optimize, guard, sync, quota and other subcommands are not modelled.

Opens the form; the finished command lands at your prompt, unrun
Run in Otty
otty gui codeburn

codeburn report

Usage report

Report spend and usage; --format json prints the full dashboard data to stdout.

Usage reportExample values, fixed in this page — nothing here reaches a terminal
Basic
Period
Last 30 daysenum
Output format
1 choicesenum
Filters
Provider
string
Only projects matching
string
Exclude projects matching
string
TasksEach one presets the form for one job
Last 30 days
periodproviderprojectexcludeformat
Date range
fromtoproviderprojectexcludeformat
ParametersOnly these flags are editable in the form
Period
enum
-ptodayweek30daysmonthalllifetime
From date
YYYY-MM-DD.
string
--from
To date
YYYY-MM-DD.
string
--to
Output format
enum
--formatjson
Provider
string
--providerclaude
Only projects matching
string · repeatable
--project
Exclude projects matching
string · repeatable
--exclude
SourcesEvery flag above is checked against these
help
Most commands also accept `--provider`, `--project` / `--exclude`, and a period flag (`-p today|week|30days|month|all|lifetime`). | `codeburn report -p 30days` | Rolling 30-day window | | `codeburn report --from 2026-04-01 --to 2026-04-10` | An exact date range | | `codeburn report --format json` | Full dashboard data as JSON, printed to stdout | codeburn re…
manualHEAD 2026-10-27

raw.githubusercontent.com

Before it fills your prompt, Otty checks the installed codeburn against its version. A form that does not match your version is not offered.