codeburn/gnome
ozymandiashh 157347aa99
feat: Amp support - read the local thread mirror (#1572) (#1578)
* feat: Amp support - read the local thread mirror (#1572)

Amp (Sourcegraph's coding agent) mirrors every thread it serves as one
JSON document per thread at ~/.local/share/amp/threads/ (AMP_DATA_DIR
honored, comma-separated). Each file is { id, messages,
usageLedger?{events} }; the ledger's events are the per-request record
(tokens.input/output, cache tokens joined from the billed message
through toMessageId -> messages[].messageId), with a per-assistant-
message usage fallback for threads without a ledger and a total-only
record billing as output.

Amp bills a subscription and records no charged dollars, so every call
is priced from the underlying model's token rates and marked
costIsEstimated; the recorded credits field is ignored (no published
per-credit dollar rate). Thread files carry no cwd, so sessions group
under the provider name. Registered eager; parse version
usage-ledger-v1; no artwork yet (mono-initial fallback, like Codebuff).

Surfaces: CLI registry + doctor probe roots, Electron sandbox read
paths + menubar catalog (Amp after Cursor, matching the Swift order),
Windows tray tab color + usage_guard root, GNOME prefs dropdown, macOS
ProviderConnectionCatalog, docs/providers/amp.md, README tool list,
CHANGELOG.

* fix: address Amp provider review feedback
2026-10-02 10:36:05 +02:00
..
icons feat: add GNOME Shell extension for Linux panel indicator 2026-05-04 09:44:35 -04:00
schemas feat(gnome): show combined usage from paired devices (#1566) 2026-09-27 16:14:53 +02:00
dataClient.js feat(gnome): show combined usage from paired devices (#1566) 2026-09-27 16:14:53 +02:00
extension.js Overhaul GNOME Shell extension with full-featured UI (#222) 2026-05-04 18:05:59 -07:00
indicator.js feat(gnome): show combined usage from paired devices (#1566) 2026-09-27 16:14:53 +02:00
install.sh feat: add GNOME Shell extension for Linux panel indicator 2026-05-04 09:44:35 -04:00
metadata.json Overhaul GNOME Shell extension with full-featured UI (#222) 2026-05-04 18:05:59 -07:00
prefs.js feat: Amp support - read the local thread mirror (#1572) (#1578) 2026-10-02 10:36:05 +02:00
README.md feat(gnome): show combined usage from paired devices (#1566) 2026-09-27 16:14:53 +02:00
stylesheet.css feat(gnome): show combined usage from paired devices (#1566) 2026-09-27 16:14:53 +02:00

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.

Combined devices

The All devices scope uses CodeBurn's existing local pairing. On another machine, run codeburn share --always, then pair it from this machine with codeburn devices add. The extension will include reachable paired devices in the combined total; sleeping or unavailable devices remain visible as unavailable rather than being counted.

Settings

Setting Default Description
Refresh Interval 30s How often to poll CodeBurn CLI
Default Period Today Period shown on open
Default Scope This device Show this device or all paired devices 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