otty / apps

All apps/CodeBurn

CodeBurn

codeburn

Runs as codeburn|macOS, Linux, Windows|codeburn.app

Open form in Otty otty.toml

Sync rules

What travels, what stays, what never leaves

CodeBurn in your home directory Every rule on this page, by file

· config.json Sync

· guard.json Sync

· sync.json Sync

· guard/ Exclude

· ~/.cache/codeburn/ Exclude

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/codeburn/otty.tomlThe file this page is generated from

id = "codeburn"

name = "CodeBurn"

homepage = "https://codeburn.app"

executables = ["codeburn"]

[dotfiles]

# CodeBurn's official docs name these user-authored configuration files. The

# docs deliberately use the literal `~/.config` path and do not state that the

# CodeBurn config follows XDG_CONFIG_HOME.

# https://codeburn.app/docs/budget

# https://codeburn.app/docs/model-aliases

# https://codeburn.app/docs/guard

# https://codeburn.app/docs/sync

paths = [

"~/.config/codeburn/config.json",

"~/.config/codeburn/guard.json",

"~/.config/codeburn/sync.json",

]

# Parsed-result caches and guard per-session state are machine state, not

# settings, and are intentionally not listed. The sync refresh token is held

# by the OS keychain when available; the docs do not specify the fallback file

# name, so that unknown credential path is not guessed here.

exclude = [

"~/.cache/codeburn/",

"~/.config/codeburn/guard/",

]

secret = []

# CodeBurn reads configuration for each command and then exits.

side_effect = false

[commands]

format = 1

label = "CodeBurn report"

description = "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."

quality = "ai-draft"

parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = false, short_bundles = false }

[[commands.subcommand]]

path = ["report"]

label = "Usage report"

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

[[commands.subcommand.source]]

id = "help"

kind = "manual"

url = "https://raw.githubusercontent.com/getagentseal/codeburn/HEAD/docs/cli.md"

revision = "HEAD 2026-10-27"

evidence = """

| `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 report --project myapp # show only projects matching "myapp"

codeburn report --exclude myapp --exclude tests # exclude multiple projects

codeburn overview --provider claude # one tool only

"""

[[commands.subcommand.field]]

id = "period"

label = "Period"

type = "enum"

option = ["-p"]

choices = [{ value = "today", label = "Today" }, { value = "week", label = "Last 7 days" }, { value = "30days", label = "Last 30 days" }, { value = "month", label = "This month" }, { value = "all", label = "All recent" }, { value = "lifetime", label = "Lifetime" }]

sources = ["help"]

[[commands.subcommand.field]]

id = "from"

label = "From date"

description = "YYYY-MM-DD."

type = "string"

option = ["--from"]

sources = ["help"]

[[commands.subcommand.field]]

id = "to"

label = "To date"

description = "YYYY-MM-DD."

type = "string"

option = ["--to"]

sources = ["help"]

[[commands.subcommand.field]]

id = "format"

label = "Output format"

type = "enum"

option = ["--format"]

choices = [{ value = "json", label = "JSON" }]

sources = ["help"]

[[commands.subcommand.field]]

id = "provider"

label = "Provider"

type = "string"

option = ["--provider"]

suggestions = [{ value = "claude", label = "Claude Code" }]

sources = ["help"]

[[commands.subcommand.field]]

id = "project"

label = "Only projects matching"

type = "string"

option = ["--project"]

multiple = true

sources = ["help"]

[[commands.subcommand.field]]

id = "exclude"

label = "Exclude projects matching"

type = "string"

option = ["--exclude"]

multiple = true

sources = ["help"]

[[commands.subcommand.task]]

id = "last-30"

label = "Last 30 days"

set = { period = ["30days"] }

fields = ["period", "provider", "project", "exclude", "format"]

required = []

[[commands.subcommand.task]]

id = "range"

label = "Date range"

fields = ["from", "to", "provider", "project", "exclude", "format"]

required = ["from"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["period", "from", "to", "format"]

[[commands.subcommand.group]]

id = "advanced"

label = "Filters"

fields = ["provider", "project", "exclude"]

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/codeburn. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these is generated from the same rules as this page.