Skip to content

Latest commit

 

History

History

README.md

CodeBurn GNOME Extension

Monitor AI coding assistant token usage and costs from your GNOME desktop panel.

Requirements

  • GNOME Shell 45 or later
  • CodeBurn CLI installed (npm i -g codeburn)
  • glib-compile-schemas (usually part of glib2-devel or libglib2.0-dev)

Install

cd gnome
chmod +x install.sh
./install.sh

Then restart GNOME Shell:

  • Wayland: Log out and back in
  • X11: Press Alt+F2, type r, press Enter

Enable the extension:

gnome-extensions enable codeburn@codeburn.dev

Configure

Open preferences:

gnome-extensions prefs codeburn@codeburn.dev

Or use the GNOME Extensions app.

Settings

Setting Default Description
Refresh Interval 30s How often to poll CodeBurn CLI
Default Period Today Period shown on open
Compact Mode Off Hide cost label, show icon only
Budget Threshold $0 Daily budget alert (0 = disabled)
Budget Alerts Off Show warning when budget exceeded
CLI Path (auto) Custom path to codeburn binary

Uninstall

gnome-extensions disable codeburn@codeburn.dev
rm -r ~/.local/share/gnome-shell/extensions/codeburn@codeburn.dev

Development

Test changes without installing:

# Compile schemas locally
glib-compile-schemas schemas/

# Symlink for development
ln -sf "$(pwd)" ~/.local/share/gnome-shell/extensions/codeburn@codeburn.dev

# Watch logs
journalctl -f -o cat /usr/bin/gnome-shell