flare 1.0.0

flare is stable. From here on the config keys, the IPC calls and the JSON
flare prints keep their meaning; new ones may be added, none will change
under you.

• More than one login: two Claude Code or Codex logins are two rings.
  ~/.claude-<name> and ~/.codex-<name> are found on their own, anything else
  goes in [[account]], and each login is read, renewed and reported on its
  own, with its initial on its ring.
• Documentation: a full reference on the site: how flare works, what it
  reads and what it sends, what it costs to run, and every setting, IPC call
  and command.
• In your app launcher: install.sh adds a flare entry that opens the
  settings page, and openSettings does the same over IPC without closing a
  page that is already open.
• Fixed: the white theme lost Cursor's, OpenCode's and Antigravity's logos;
  the usage panel reopened where it was left instead of at the top; a long
  pace line ran out of its card; two logins' session lists in the compact
  panel did not say whose they were.
• A logo of its own, and new screenshots, drawn from a made-up world with
  tools/shots/shots.sh so they never show anyone's real usage.

Install

git clone https://github.com/lunanoir21/flare-notch
cd flare-notch
./install.sh

flare-x86_64-linux.tar.gz is the prebuilt binary install.sh downloads when Rust is not installed (x86_64, glibc 2.39+).

flare 0.3.0

• Antigravity and Kiro: two more providers. Antigravity reads each model
  group's quota from its own status line capture (hooks/agy-statusline-capture.sh)
  and today's tokens and models from its conversation databases; Kiro reads the
  month's credits from AWS, or from its session files alone in local mode.
• The usage panel, redone: a deck of provider cards across the top — step
  through with the arrows — and, for the one picked, its limits, how the
  longest one filled, the last seven days, the hours of the day, the models
  that took the most and the week's sessions.
• Sessions from a provider's own history: OpenCode, Antigravity and Kiro
  now list closed sessions on the timeline too, not just ones still running.
• usage.all_providers: list, and read, providers switched off in the
  widget in the usage panel too.
• A provider that meters in credits (Kiro) shows credits, not tokens,
  throughout the panel and its cards.

Also carries everything from 0.2.0, skipped as a release on its own:

• The usage panel (first cut): an hour-by-hour heatmap of the week, token
  counts read straight from a provider's own logs, busiest hours, quietest
  day and today's sessions on a timeline.
• Notifications: flare watch runs in the background, only while
  [notify] has something switched on, and tells you when a session starts
  waiting on you, a limit reaches its threshold, or a limit you had been
  using resets.
• notch.label: show the time left under a ring instead of (or beside)
  the percentage.
• Session log: flare now remembers a session for a week after it closes.
• Fixed: Claude token counts were inflated, sometimes by a lot.

Install

git clone https://github.com/lunanoir21/quickshell-flare
cd quickshell-flare
./install.sh

flare-x86_64-linux.tar.gz is the prebuilt binary install.sh downloads when Rust is not installed (x86_64, glibc 2.39+).

flare 0.2.0

• The usage panel: an hour-by-hour heatmap of the week, token counts read
  straight from a provider's own logs (each reply counted once), busiest hours,
  quietest day and today's sessions on a timeline. Open it from the arrow on a
  provider's hover card, or qs ipc call flare usage <provider>.
• Notifications: flare watch runs in the background, only while [notify]
  has something switched on, and tells you when a session starts waiting on you,
  a limit reaches its threshold, or a limit you had been using resets.
• notch.label: show the time left under a ring instead of (or beside) the
  percentage.
• Session log: flare now remembers a session for a week after it closes, so
  the usage panel's timeline has something to draw for earlier today.
• Fixed: Claude token counts were inflated, sometimes by a lot — Claude Code
  writes a reply's usage on every content-block line, and a resumed session
  copies old replies into its new log. Both are now counted once. A single very
  long line (tool output) no longer stops the rest of a log file from being read.

Install

git clone https://github.com/lunanoir21/flare-notch
cd flare-notch
./install.sh

flare-x86_64-linux.tar.gz is the prebuilt binary install.sh downloads when Rust is not installed (x86_64, glibc 2.39+).

flare 0.1.1

• Sessions in every look: aura opens the same hover card as classic from its
  ring, with a dot per open session under it, and compact lists the sessions under
  its provider rows.
• Smoother compact panel: opening the session list no longer resizes the
  panel's window on every frame, and the panel opens and closes faster.
• card in aura switches to that provider before opening its card.
• A website: lunanoir21.github.io/quickshell-flare,
  with a working copy of the notch, the credits and this changelog, in black or
  white.
• install.sh suggests setting flare.binary_path when it installs somewhere the
  widget does not look.

Install

git clone https://github.com/lunanoir21/quickshell-flare
cd quickshell-flare
./install.sh

flare-x86_64-linux.tar.gz is the prebuilt binary install.sh downloads when Rust is not installed (x86_64, glibc 2.39+).

flare 0.1.0

The first release.

• Providers: Claude Code, Codex, Cursor and OpenCode, read the way Codenotch
  reads them (data.mode = "official"), or from disk alone ("local").
• Three looks: classic, aura and compact, each mounted as bridge, floating or
  flush, on any edge the style allows.
• Reveal: always on screen, slide in on hover, or bring in with a key.
• Hover card: Codenotch's black card, with bars that go green, orange and red as
  a limit fills.
• Open sessions: the card lists the Claude Code sessions running right now,
  whether each is working or waiting on you, and clicking one brings its terminal
  to the front (Hyprland).
• Keyboard only: qs ipc call flare card claude opens the hover card without the
  pointer; toggleSessions folds the session list.
• English and Turkish: follows the locale, or ui.language.
• Settings page: every option, with a live preview; it writes the same
  ~/.config/flare/config.toml that flare config set does.
• Light on resources: nothing is read while the widget is out of sight, and
  network reads keep their own pace however often the widget refreshes.
• install.sh builds from source when Rust is there, and downloads this release's
  binary otherwise.

Install

git clone https://github.com/lunanoir21/quickshell-flare
cd quickshell-flare
./install.sh

flare-x86_64-linux.tar.gz is the prebuilt flare binary that install.sh downloads when Rust is not installed. It needs x86_64 Linux with glibc 2.39 or newer (Arch, Fedora 40+, Ubuntu 24.04+). Quickshell 0.3+ and Qt 6.6+ are needed either way.