vrr/codeburn
2
0
Fork 0
mirror of https://github.com/AgentSeal/codeburn.git synced 2026-05-20 00:57:09 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 1
codeburn/extensions/gnome-shell
History
AgentSeal e246aa9ece feat(extensions): insight pills + token histogram chart on GNOME 
Port Wave 1 of the Mac popover to the GNOME extension:

* Insight pills row (Activity, Trend, Forecast, Pulse, Stats, Plan) below
  period tabs. Clicking a pill swaps the content area between views.
* 19-day token histogram chart between period tabs and content area.
  Each bar scales to the top-token day, rendered as a St.Widget with a
  brand-orange linear gradient.
* Six view implementations:
  - Activity (default): current activity rows + top 3 models
  - Trend: last 7 days, per-day cost and call count
  - Forecast: 7-day avg, yesterday, day-over-day %, month projection
  - Pulse: three KPI tiles (cost, calls, cache hit) + last-7-day summary
  - Stats: favorite model, active days, current streak, peak day
  - Plan: placeholder (Claude OAuth is macOS-only until Wave 3)

Shared helpers:
* _sectionTitle, _kvRow, _pulseTile for consistent row layouts
* formatTokensCompact for 1.2k / 4.5M / 2.3B token totals
2026-04-18 05:44:10 -07:00
..
codeburn@agentseal.org feat(extensions): insight pills + token histogram chart on GNOME 2026-04-18 05:44:10 -07:00
README.md feat(extensions): add GNOME Shell extension for native panel feel 2026-04-18 04:06:44 -07:00

README.md

CodeBurn GNOME Shell extension

Native GNOME panel button that shows today's AI coding spend with a click-to-open popover, matching the feel of Ubuntu's Quick Settings menu.

This is an alternative to the cross-platform Tauri tray app in ../desktop/. Use this on GNOME for the most native UX. The Tauri app stays the right choice for KDE, Unity, wlroots compositors, Windows, and headless systems.

Requirements

  • GNOME Shell 45, 46, 47, or 48 (Ubuntu 22.04 LTS, 24.04 LTS, and Fedora 39+)
  • codeburn CLI on PATH (npm install -g codeburn)

Install (from source, local user)

cp -r extensions/gnome-shell/codeburn@agentseal.org ~/.local/share/gnome-shell/extensions/
gnome-extensions enable codeburn@agentseal.org

Then restart GNOME Shell so the extension loads:

  • X11: press Alt + F2, type r, press Enter.
  • Wayland: log out and log back in (GNOME on Wayland has no in-session shell restart).

What it shows

Panel button:

  • 🔥 icon
  • Today's cost (e.g. $24.73)

Popup menu:

  • Header: period + cost + call count + session count
  • Top 5 activities (Coding, Debugging, Testing, etc.) with per-activity cost and turn count
  • Optimize findings count with potential savings (if any)
  • Refresh and Open Full Report actions

Data refreshes every 60 seconds. Right-click the panel button to open the default panel context menu.

Uninstall

gnome-extensions disable codeburn@agentseal.org
rm -rf ~/.local/share/gnome-shell/extensions/codeburn@agentseal.org

Development

Run a nested shell to iterate without restarting your session (X11 only):

dbus-run-session -- gnome-shell --nested --wayland

Tail the extension log:

journalctl -f -o cat /usr/bin/gnome-shell

The extension uses the GNOME 45+ ESM-based extension API (import + Extension class). It will not load on GNOME 44 or earlier.