codeburn/extensions/gnome-shell/codeburn@agentseal.org/extension.js
AgentSeal 5e68981723 feat(extensions): add agent filter and currency switcher to GNOME popup
Adds two more submenus so the GNOME popup matches the agent tabs and
currency picker the Mac menubar app ships with.

* Agent submenu: All / Claude / Codex / Cursor / Copilot. Passes --provider
  through to codeburn status and codeburn report so the numbers and the
  full terminal report both follow the selected filter.
* Currency submenu: 17 ISO codes (USD, EUR, GBP, CAD, AUD, JPY, INR, BRL,
  CHF, SEK, SGD, HKD, KRW, MXN, ZAR, DKK, CNY). Selecting a code shells
  out to codeburn currency <code> and refreshes the popup with the new
  symbol. The current currency is read from ~/.config/codeburn/config.json
  on startup and after each change so all of our surfaces agree.
* formatCost takes the active currency so activity, model, provider and
  findings rows render with the right symbol instead of hardcoded $.
2026-04-18 04:35:29 -07:00

460 lines
17 KiB
JavaScript

/*
* CodeBurn GNOME Shell extension.
*
* Renders a flame + current-period cost label in the top panel and opens a native
* PopupMenu on click. Unlike the Tauri tray app (desktop/), this lives inside
* gnome-shell so it can anchor the popover directly under the panel button,
* matching Ubuntu's Quick Settings feel.
*
* Data source: `codeburn status --format menubar-json --period <p>`, polled every
* 60s. The period is a per-session preference held in memory on the indicator.
*/
import GObject from 'gi://GObject';
import St from 'gi://St';
import Gio from 'gi://Gio';
import GLib from 'gi://GLib';
import Clutter from 'gi://Clutter';
import * as Main from 'resource:///org/gnome/shell/ui/main.js';
import * as PanelMenu from 'resource:///org/gnome/shell/ui/panelMenu.js';
import * as PopupMenu from 'resource:///org/gnome/shell/ui/popupMenu.js';
import {Extension} from 'resource:///org/gnome/shell/extensions/extension.js';
const REFRESH_INTERVAL_SECONDS = 60;
const TOP_ACTIVITIES = 5;
const TOP_MODELS = 3;
const TOP_PROVIDERS = 4;
const CODEBURN_BIN = 'codeburn';
const PERIODS = [
{id: 'today', label: 'Today'},
{id: 'week', label: '7 Days'},
{id: '30days', label: '30 Days'},
{id: 'month', label: 'Month'},
{id: 'all', label: 'All Time'},
];
const PROVIDERS = [
{id: 'all', label: 'All'},
{id: 'claude', label: 'Claude'},
{id: 'codex', label: 'Codex'},
{id: 'cursor', label: 'Cursor'},
{id: 'copilot', label: 'Copilot'},
];
// Matches the 17 currencies the Mac menubar ships with. Symbols fall back to the
// ISO code with a trailing space for anything less common.
const CURRENCIES = [
{code: 'USD', symbol: '$'},
{code: 'EUR', symbol: '€'},
{code: 'GBP', symbol: '£'},
{code: 'CAD', symbol: 'C$'},
{code: 'AUD', symbol: 'A$'},
{code: 'JPY', symbol: '¥'},
{code: 'INR', symbol: '₹'},
{code: 'BRL', symbol: 'R$'},
{code: 'CHF', symbol: 'CHF '},
{code: 'SEK', symbol: 'kr '},
{code: 'SGD', symbol: 'S$'},
{code: 'HKD', symbol: 'HK$'},
{code: 'KRW', symbol: '₩'},
{code: 'MXN', symbol: 'MX$'},
{code: 'ZAR', symbol: 'R '},
{code: 'DKK', symbol: 'kr '},
{code: 'CNY', symbol: '¥'},
];
const CodeburnIndicator = GObject.registerClass(
class CodeburnIndicator extends PanelMenu.Button {
_init() {
super._init(0.0, 'CodeBurn');
this._period = 'today';
this._provider = 'all';
this._currency = this._loadCurrency();
this._loading = false;
this._timeout = null;
this._payload = null;
// Follow the GNOME system color-scheme so the popup stays readable on both
// light and dark themes. Adds .codeburn-dark / .codeburn-light to the root
// widget so stylesheet.css can tweak per-theme without fighting the shell's
// inherited palette.
this._themeSettings = new Gio.Settings({schema_id: 'org.gnome.desktop.interface'});
this._themeSignal = this._themeSettings.connect('changed::color-scheme', () => this._applyThemeClass());
this._applyThemeClass();
const box = new St.BoxLayout({style_class: 'panel-status-menu-box codeburn-panel'});
this._flame = new St.Label({
text: '🔥',
y_align: Clutter.ActorAlign.CENTER,
style_class: 'codeburn-flame',
});
this._label = new St.Label({
text: '…',
y_align: Clutter.ActorAlign.CENTER,
style_class: 'codeburn-label',
});
box.add_child(this._flame);
box.add_child(this._label);
this.add_child(box);
this._buildMenu();
this._refresh();
this._timeout = GLib.timeout_add_seconds(
GLib.PRIORITY_DEFAULT,
REFRESH_INTERVAL_SECONDS,
() => {
this._refresh();
return GLib.SOURCE_CONTINUE;
},
);
}
_buildMenu() {
// Header: period + hero cost + calls + sessions
this._headerItem = new PopupMenu.PopupMenuItem('Loading…', {reactive: false});
this._headerItem.label.style_class = 'codeburn-header';
this.menu.addMenuItem(this._headerItem);
this._metaItem = new PopupMenu.PopupMenuItem('', {reactive: false});
this._metaItem.label.style_class = 'codeburn-meta';
this.menu.addMenuItem(this._metaItem);
this.menu.addMenuItem(new PopupMenu.PopupSeparatorMenuItem());
// Agent (provider filter) submenu
this._providerSubmenu = new PopupMenu.PopupSubMenuMenuItem(this._providerLabel());
for (const p of PROVIDERS) {
const item = new PopupMenu.PopupMenuItem(p.label);
item.connect('activate', () => {
this._provider = p.id;
this._providerSubmenu.label.set_text(this._providerLabel());
this._refresh();
});
this._providerSubmenu.menu.addMenuItem(item);
}
this.menu.addMenuItem(this._providerSubmenu);
// Period switcher submenu
this._periodSubmenu = new PopupMenu.PopupSubMenuMenuItem(this._periodLabel());
for (const p of PERIODS) {
const item = new PopupMenu.PopupMenuItem(p.label);
item.connect('activate', () => {
this._period = p.id;
this._periodSubmenu.label.set_text(this._periodLabel());
this._refresh();
});
this._periodSubmenu.menu.addMenuItem(item);
}
this.menu.addMenuItem(this._periodSubmenu);
// Currency submenu
this._currencySubmenu = new PopupMenu.PopupSubMenuMenuItem(this._currencyLabel());
for (const c of CURRENCIES) {
const item = new PopupMenu.PopupMenuItem(c.code);
item.connect('activate', () => this._setCurrency(c.code));
this._currencySubmenu.menu.addMenuItem(item);
}
this.menu.addMenuItem(this._currencySubmenu);
this.menu.addMenuItem(new PopupMenu.PopupSeparatorMenuItem());
// Activities, models, providers, findings (populated on render)
this._activitySection = new PopupMenu.PopupMenuSection();
this.menu.addMenuItem(this._activitySection);
this._modelsSection = new PopupMenu.PopupMenuSection();
this.menu.addMenuItem(this._modelsSection);
this._providersSection = new PopupMenu.PopupMenuSection();
this.menu.addMenuItem(this._providersSection);
this._findingsSection = new PopupMenu.PopupMenuSection();
this.menu.addMenuItem(this._findingsSection);
this.menu.addMenuItem(new PopupMenu.PopupSeparatorMenuItem());
// Footer: updated timestamp, refresh, open full report
this._updatedItem = new PopupMenu.PopupMenuItem('', {reactive: false});
this._updatedItem.label.style_class = 'codeburn-updated';
this.menu.addMenuItem(this._updatedItem);
const refresh = new PopupMenu.PopupMenuItem('Refresh');
refresh.connect('activate', () => this._refresh());
this.menu.addMenuItem(refresh);
const openReport = new PopupMenu.PopupMenuItem('Open Full Report');
openReport.connect('activate', () => this._spawnTerminal([CODEBURN_BIN, 'report', '--period', this._period, '--provider', this._provider]));
this.menu.addMenuItem(openReport);
}
_periodLabel() {
const p = PERIODS.find(x => x.id === this._period);
return `Period · ${p ? p.label : this._period}`;
}
_providerLabel() {
const p = PROVIDERS.find(x => x.id === this._provider);
return `Agent · ${p ? p.label : this._provider}`;
}
_currencyLabel() {
return `Currency · ${this._currency.code}`;
}
_loadCurrency() {
const configPath = GLib.build_filenamev([GLib.get_home_dir(), '.config', 'codeburn', 'config.json']);
try {
const [ok, contents] = GLib.file_get_contents(configPath);
if (ok) {
const config = JSON.parse(new TextDecoder().decode(contents));
if (config.currency?.code) {
const known = CURRENCIES.find(c => c.code === config.currency.code);
if (known) return known;
return {code: config.currency.code, symbol: config.currency.symbol || `${config.currency.code} `};
}
}
} catch (_) {
// fall through to default
}
return CURRENCIES[0];
}
_setCurrency(code) {
let proc;
try {
proc = Gio.Subprocess.new(
[CODEBURN_BIN, 'currency', code],
Gio.SubprocessFlags.STDOUT_PIPE | Gio.SubprocessFlags.STDERR_PIPE,
);
} catch (_) {
return;
}
proc.wait_async(null, () => {
this._currency = this._loadCurrency();
this._currencySubmenu.label.set_text(this._currencyLabel());
this._refresh();
});
}
_refresh() {
if (this._loading) return;
this._loading = true;
this._headerItem.label.set_text(this._payload ? this._headerItem.label.get_text() : 'Loading…');
let proc;
try {
proc = Gio.Subprocess.new(
[CODEBURN_BIN, 'status', '--format', 'menubar-json', '--period', this._period, '--provider', this._provider],
Gio.SubprocessFlags.STDOUT_PIPE | Gio.SubprocessFlags.STDERR_PIPE,
);
} catch (e) {
this._loading = false;
this._renderError('codeburn CLI not found on PATH. Install the npm package first.');
return;
}
proc.communicate_utf8_async(null, null, (p, result) => {
this._loading = false;
try {
const [ok, stdout, stderr] = p.communicate_utf8_finish(result);
if (!ok) {
this._renderError(`codeburn failed: ${stderr || 'unknown error'}`);
return;
}
if (!stdout) {
this._renderError('codeburn returned no output');
return;
}
const payload = JSON.parse(stdout);
this._payload = payload;
this._render(payload);
} catch (e) {
this._renderError(`parse error: ${e.message}`);
}
});
}
_render(payload) {
const current = payload?.current ?? {};
const cost = Number(current.cost ?? 0);
const formatted = formatCost(cost, this._currency);
this._label.set_text(formatted);
const label = current.label ?? '';
const calls = Number(current.calls ?? 0);
const sessions = Number(current.sessions ?? 0);
const oneShot = current.oneShotRate;
const cacheHit = Number(current.cacheHitPercent ?? 0);
this._headerItem.label.set_text(`${label} ${formatted}`);
const metaParts = [
`${calls.toLocaleString()} calls`,
`${sessions} sessions`,
`${cacheHit.toFixed(0)}% cache`,
];
if (oneShot !== null && oneShot !== undefined) {
metaParts.push(`${Math.round(Number(oneShot) * 100)}% 1-shot`);
}
this._metaItem.label.set_text(metaParts.join(' '));
this._renderActivities(current.topActivities ?? []);
this._renderModels(current.topModels ?? []);
this._renderProviders(current.providers ?? {});
this._renderFindings(payload?.optimize ?? {});
const updated = payload?.generated ? formatTime(new Date(payload.generated)) : '';
this._updatedItem.label.set_text(updated ? `Updated ${updated}` : '');
}
_renderActivities(activities) {
this._activitySection.removeAll();
if (!activities.length) {
const empty = new PopupMenu.PopupMenuItem('No activity for this period', {reactive: false});
empty.label.style_class = 'codeburn-empty';
this._activitySection.addMenuItem(empty);
return;
}
const title = new PopupMenu.PopupMenuItem('Activity', {reactive: false});
title.label.style_class = 'codeburn-section-title';
this._activitySection.addMenuItem(title);
for (const a of activities.slice(0, TOP_ACTIVITIES)) {
const oneShot = a.oneShotRate;
const tail = oneShot == null
? `${a.turns} turns`
: `${a.turns} turns ${Math.round(Number(oneShot) * 100)}% 1-shot`;
const line = ` ${a.name.padEnd(14)} ${formatCost(a.cost, this._currency).padStart(8)} ${tail}`;
const item = new PopupMenu.PopupMenuItem(line, {reactive: false});
item.label.style_class = 'codeburn-row';
this._activitySection.addMenuItem(item);
}
}
_renderModels(models) {
this._modelsSection.removeAll();
if (!models.length) return;
const title = new PopupMenu.PopupMenuItem('Models', {reactive: false});
title.label.style_class = 'codeburn-section-title';
this._modelsSection.addMenuItem(title);
for (const m of models.slice(0, TOP_MODELS)) {
const calls = Number(m.calls ?? 0).toLocaleString();
const line = ` ${m.name.padEnd(18)} ${formatCost(m.cost, this._currency).padStart(8)} ${calls} calls`;
const item = new PopupMenu.PopupMenuItem(line, {reactive: false});
item.label.style_class = 'codeburn-row';
this._modelsSection.addMenuItem(item);
}
}
_renderProviders(providers) {
this._providersSection.removeAll();
const entries = Object.entries(providers).filter(([, cost]) => Number(cost) > 0);
if (entries.length <= 1) return;
entries.sort((a, b) => Number(b[1]) - Number(a[1]));
const title = new PopupMenu.PopupMenuItem('Providers', {reactive: false});
title.label.style_class = 'codeburn-section-title';
this._providersSection.addMenuItem(title);
for (const [name, cost] of entries.slice(0, TOP_PROVIDERS)) {
const line = ` ${capitalize(name).padEnd(14)} ${formatCost(Number(cost), this._currency).padStart(8)}`;
const item = new PopupMenu.PopupMenuItem(line, {reactive: false});
item.label.style_class = 'codeburn-row';
this._providersSection.addMenuItem(item);
}
}
_renderFindings(optimize) {
this._findingsSection.removeAll();
const count = Number(optimize?.findingCount ?? 0);
if (count === 0) return;
const savings = Number(optimize?.savingsUSD ?? 0);
const text = `${count} optimize findings save ~${formatCost(savings, this._currency)}`;
const item = new PopupMenu.PopupMenuItem(text);
item.label.style_class = 'codeburn-findings';
item.connect('activate', () => this._spawnTerminal([CODEBURN_BIN, 'optimize']));
this._findingsSection.addMenuItem(item);
}
_renderError(message) {
this._label.set_text('!');
this._headerItem.label.set_text(message);
this._metaItem.label.set_text('');
this._activitySection.removeAll();
this._modelsSection.removeAll();
this._providersSection.removeAll();
this._findingsSection.removeAll();
}
_spawnTerminal(argv) {
// Quote arguments into a single command string for bash -lc. argv here only ever
// contains static identifiers from our own code so plain join is safe.
const command = `${argv.join(' ')}; echo; read -n 1 -s -r -p 'Press any key to close...'`;
try {
Gio.Subprocess.new(
['gnome-terminal', '--', 'bash', '-lc', command],
Gio.SubprocessFlags.NONE,
);
} catch (e) {
log(`codeburn: terminal spawn error: ${e.message}`);
}
}
_applyThemeClass() {
const scheme = this._themeSettings.get_string('color-scheme');
const isDark = scheme === 'prefer-dark';
this.add_style_class_name(isDark ? 'codeburn-dark' : 'codeburn-light');
this.remove_style_class_name(isDark ? 'codeburn-light' : 'codeburn-dark');
}
destroy() {
if (this._timeout) {
GLib.source_remove(this._timeout);
this._timeout = null;
}
if (this._themeSettings && this._themeSignal) {
this._themeSettings.disconnect(this._themeSignal);
this._themeSignal = null;
this._themeSettings = null;
}
super.destroy();
}
});
function formatCost(value, currency) {
const n = Number(value) || 0;
const abs = Math.abs(n);
const symbol = currency?.symbol || '$';
if (abs >= 1000) {
return `${symbol}${(n / 1000).toFixed(abs >= 10000 ? 0 : 1)}k`;
}
return `${symbol}${n.toFixed(2)}`;
}
function formatTime(date) {
if (!date || Number.isNaN(date.getTime())) return '';
const now = new Date();
const diffSec = Math.floor((now.getTime() - date.getTime()) / 1000);
if (diffSec < 60) return 'just now';
if (diffSec < 3600) return `${Math.floor(diffSec / 60)}m ago`;
if (diffSec < 86400) return `${Math.floor(diffSec / 3600)}h ago`;
return date.toLocaleDateString();
}
function capitalize(s) {
if (!s) return s;
return s.charAt(0).toUpperCase() + s.slice(1);
}
export default class CodeburnExtension extends Extension {
enable() {
this._indicator = new CodeburnIndicator();
Main.panel.addToStatusArea('codeburn', this._indicator);
}
disable() {
this._indicator?.destroy();
this._indicator = null;
}
}