Release v0.1.1: fresh-install polish

Three fixes surfaced during a from-scratch install walkthrough:

- codexbar.sh now reads the enabled-provider list from
  ~/.codexbar/config.json (with a (codex claude gemini) fallback when the
  config is missing). Override per-instance with CODEXBAR_PROVIDERS. A
  Codex-only user no longer sees Claude/Gemini error tabs in the popover.

- The module's interval drops from 60s to 30s and declares signal 8 so
  pkill -RTMIN+8 waybar triggers an immediate refresh. The popover sends
  that signal right after a Settings Save so the bar reflects the new
  provider list without waiting for the next tick.

- install.sh hard-fails when 'codexbar' is missing from PATH and prints
  the exact tarball + libxml2-legacy commands inline, instead of leaving
  the user with a silent half-install.

Also fixes codexbar.jsonc click handler that still pointed at notify-send
instead of the GTK popover.

Author: Marouan-chak

CHANGELOG.md

@@ -7,15 +7,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.1] — 2026-05-16
+
 ### Changed
-- **Settings is now an inline view inside the popover** — no external editor,
-  no JSON file opened in a browser. Clicking *Settings…* swaps the popup
-  body to a scrollable provider list with per-provider toggle switches.
-  *Save* writes back to `~/.codexbar/config.json` and refreshes the data;
-  *Back* cancels.
-- Linux-unsupported providers (macOS-only web/cookie sources) appear in their
-  own grayed-out section with a "macOS only" hint, so it's obvious why you
-  can't enable them without trial-and-error.
+- **Wrapper script reads enabled providers from `~/.codexbar/config.json`**
+  instead of hardcoding `(codex claude gemini)`. A Codex-only user no longer
+  sees Claude/Gemini error tabs. Override per-instance with
+  `CODEXBAR_PROVIDERS="codex claude"` if you need to bypass the config.
+- **Default refresh interval dropped from 60 s to 30 s** and the module now
+  declares `signal: 8`, so a `pkill -RTMIN+8 waybar` forces an immediate
+  refresh. The popover sends that signal after a Save so the bar reflects
+  toggled providers without waiting for the next tick.
+- **`install.sh` now hard-fails if the `codexbar` CLI is missing**, with the
+  exact tarball + libxml2-legacy commands inline. Previous behaviour was a
+  soft warning that left users with a silent half-install.
+- **Inline Settings view** (already in 0.1.1 — moved out of Unreleased):
+  clicking *Settings…* swaps the popover body to a scrollable provider
+  list with per-provider toggle switches and a *Save* button. macOS-only
+  providers appear in a separate grayed section with a hint, so users
+  don't waste time enabling things that can't work on Linux.
 
 ## [0.1.0] — 2026-05-16
 
@@ -34,5 +44,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   the Waybar entry.
 - `install.sh` — idempotent installer.
 
-[Unreleased]: https://github.com/Marouan-chak/codexbar-waybar/compare/v0.1.0...HEAD
+[Unreleased]: https://github.com/Marouan-chak/codexbar-waybar/compare/v0.1.1...HEAD
+[0.1.1]: https://github.com/Marouan-chak/codexbar-waybar/releases/tag/v0.1.1
 [0.1.0]: https://github.com/Marouan-chak/codexbar-waybar/releases/tag/v0.1.0

README.md

@@ -121,12 +121,16 @@ definition or your shell profile.
 | --- | --- | --- |
 | `CODEXBAR_BIN` | `~/.local/bin/codexbar` | Path to the CLI binary. |
 | `CODEXBAR_STAGGER` | `0.5` | Seconds between provider fetches (raises this if Claude OAuth keeps 429-ing). |
+| `CODEXBAR_PROVIDERS` | from config.json | Space-separated provider IDs to query, bypassing `~/.codexbar/config.json`. Set per-Waybar instance if you want different provider sets per monitor. |
 | `XDG_CACHE_HOME` | `~/.cache` | Where `last.json` snapshots live. |
 | `CODEXBAR_LAYER_SHELL_LIB` | auto-detected | Override path to `libgtk4-layer-shell.so` if your distro stashes it somewhere unusual. |
 
-To change which providers appear, edit `PROVIDERS=( … )` and `SOURCE_OVERRIDES`
-at the top of `codexbar.sh`. Codex and Claude need `--source oauth` on Linux
-because their `auto` source tries the (macOS-only) web scrape first.
+To change which providers appear, open the popover and click **Settings…** —
+the inline view lets you toggle providers and Save back to
+`~/.codexbar/config.json`. The wrapper script picks up the new list on the
+next refresh (the popover nudges Waybar to refresh immediately via
+`SIGRTMIN+8`). Codex and Claude need `--source oauth` on Linux; the wrapper
+sets that automatically via `SOURCE_OVERRIDES` at the top of `codexbar.sh`.
 
 ## How it works
 

codexbar-popup.py

@@ -510,6 +510,9 @@ def _on_settings_save(self):
         self.view = "usage"
         self.render()
         self.refresh(background=True)
+        # Nudge waybar so the bar reflects the new provider list without
+        # waiting for the next interval. The signal is wired up in codexbar.jsonc.
+        subprocess.Popen(["pkill", "-RTMIN+8", "waybar"])
 
     def refresh(self, *, background: bool):
         def worker():

codexbar.jsonc

@@ -1,20 +1,19 @@
-// Waybar custom-module definition for CodexBar.
+// Waybar custom-module definition for codexbar-waybar.
 //
-// Install:
-//   install -m 0644 codexbar.jsonc ~/.config/waybar/modules/custom-codexbar.json
+// install.sh drops this at ~/.config/waybar/modules/custom-codexbar.json.
+// You then reference "custom/codexbar" from a modules-right group in your
+// ~/.config/waybar/config.jsonc — see README.md for the snippet.
 //
-// Then reference "custom/codexbar" in one of your modules-right groups
-// in ~/.config/waybar/config.jsonc, e.g.:
-//   "modules-right": ["custom/codexbar", "clock", "battery"]
-//
-// See docs/linux-waybar.md for the full walkthrough.
+// To force a refresh from elsewhere:  pkill -RTMIN+8 waybar
 {
     "custom/codexbar": {
         "exec": "$HOME/.config/waybar/scripts/codexbar.sh",
         "return-type": "json",
         "format": "{}",
-        "interval": 60,
-        "on-click": "bash -c 'notify-send -a CodexBar -t 10000 \"AI usage\" \"$($HOME/.config/waybar/scripts/codexbar.sh | jq -r .tooltip)\"'",
+        "interval": 30,
+        "signal": 8,
+        "on-click": "$HOME/.config/waybar/scripts/codexbar-popup.py",
+        "on-click-right": "bash -c 'notify-send -a CodexBar -t 8000 \"AI usage\" \"$($HOME/.config/waybar/scripts/codexbar.sh | jq -r .tooltip)\"'",
         "tooltip": true,
         "max-length": 24
     }

codexbar.sh

@@ -6,18 +6,33 @@
 # Last successful per-provider snapshot is cached, so a transient 429 is masked
 # until the next refresh recovers it.
 #
-# Linux-only providers used here (cookies/web providers are macOS-only).
-# Edit PROVIDERS / SOURCE_OVERRIDES below to add more.
+# Linux-only providers — cookies/web providers are macOS-only. The list is
+# read from ~/.codexbar/config.json (use the popover's Settings view to
+# manage it); falls back to codex+claude+gemini if the file is missing.
 
 set -u
 
 CODEXBAR="${CODEXBAR_BIN:-${HOME}/.local/bin/codexbar}"
+CONFIG_PATH="${HOME}/.codexbar/config.json"
 CACHE_DIR="${XDG_CACHE_HOME:-${HOME}/.cache}/codexbar-waybar"
 mkdir -p "$CACHE_DIR"
 
-# Provider list and per-provider source override.
-# Codex/Claude need explicit --source oauth on Linux (auto tries web first).
-PROVIDERS=(codex claude gemini)
+# Read enabled providers from the codexbar CLI's config, fall back to a
+# sensible default if it's missing or unreadable. Override with the
+# CODEXBAR_PROVIDERS env var (space-separated list) when you want to bypass
+# config.json for a specific waybar instance.
+if [[ -n "${CODEXBAR_PROVIDERS:-}" ]]; then
+    # shellcheck disable=SC2206
+    PROVIDERS=( ${CODEXBAR_PROVIDERS} )
+elif [[ -f "$CONFIG_PATH" ]] && command -v jq >/dev/null 2>&1; then
+    readarray -t PROVIDERS < <(jq -r '[.providers[]? | select(.enabled == true) | .id] | .[]' "$CONFIG_PATH" 2>/dev/null)
+    [[ ${#PROVIDERS[@]} -eq 0 ]] && PROVIDERS=(codex claude gemini)
+else
+    PROVIDERS=(codex claude gemini)
+fi
+
+# Per-provider --source override. Codex/Claude need explicit oauth on Linux
+# (their `auto` falls back to web first, which is macOS-only).
 declare -A SOURCE_OVERRIDES=(
     [codex]=oauth
     [claude]=oauth

install.sh

@@ -24,8 +24,20 @@ yellow() { printf '\033[33m%s\033[0m\n' "$*"; }
 
 # 1. codexbar binary check
 if ! command -v codexbar >/dev/null 2>&1; then
-    yellow "Warning: 'codexbar' is not on PATH."
-    yellow "Install the Linux CLI before continuing — see README.md for the tarball + libxml2-legacy notes."
+    red "'codexbar' is not on PATH."
+    cat <<'EOF' >&2
+
+Install the Linux CLI first:
+
+  curl -LO https://github.com/steipete/CodexBar/releases/latest/download/CodexBarCLI-linux-x86_64.tar.gz
+  tar -xzf CodexBarCLI-linux-x86_64.tar.gz
+  install -m 0755 CodexBarCLI ~/.local/bin/codexbar
+
+Arch users also need:  sudo pacman -S libxml2-legacy
+
+Then re-run this installer.
+EOF
+    exit 1
 fi
 
 # 2. Required deps