CodeBurn for DankMaterialShell

Monitor AI coding assistant token usage and costs from your DankBar — a port of the CodeBurn GNOME extension to DankMaterialShell.

Features

• DankBar pill with flame icon and current-period cost (compact mode: icon only)
• Popup dashboard: provider tabs, hero summary, period tabs (Today / 7 Days / 30 Days / Month / 6 Months), insight views (Activity / Trend / Forecast / Pulse / Stats), 19-day token chart, budget warning, optimize-findings button, currency picker (18 currencies with FX conversion)
• All data from the local codeburn CLI — no accounts, no cloud

Requirements

• DankMaterialShell ≥ 1.2.0 on Quickshell
• CodeBurn CLI installed (npm i -g codeburn)
• bash, jq

Install

git clone <this-repo> ~/.config/DankMaterialShell/plugins/codeburn
chmod +x ~/.config/DankMaterialShell/plugins/codeburn/providers/*
dms restart

Enable CodeBurn in DMS settings and add it to a DankBar section.

Settings

Setting	Values	Default
Refresh interval	5–300 s	30
Default period	today, week, 30days, month, all	today
Compact mode	on/off	off
Show exact costs	on/off	off
Budget alerts	on/off	off
Daily budget (USD)	0–1000 (0 disables)	0
Disabled providers	per-provider toggles	all enabled
CodeBurn CLI path	path or empty (PATH)	empty

Development

Source of truth for UX and the menubar-json payload contract is the GNOME extension at codeburn/gnome. Planning artifacts live in openspec/changes/port-gnome-extension-to-dms/.

Validate:

jq -e . plugin.json >/dev/null
shellcheck -S warning providers/*
qmllint CodeBurnWidget.qml CodeBurnSettings.qml
./providers/get-codeburn-usage today all | jq .