Waybar custom module for CodexBar usage data.

It shows Codex and Claude remaining usage in the bar and renders a rich tooltip with:

• session and weekly meters
• CodexBar-compatible pace wording (in deficit, in reserve, Expected X% used)
• reset countdowns
• run-out / lasts-until-reset projection
• Codex credits when available

• Arch Linux / Waybar
• jq
• Ruby for the installer/uninstaller helpers

The package bundles the upstream CodexBar Linux CLI release from https://github.com/steipete/codexbar and installs it as /usr/bin/codexbar, so a separate CodexBar or Homebrew install is not required.

If you previously had a hand-written ~/.local/bin/codexbar-waybar, remove it; otherwise it can shadow the packaged executable. If you have another codexbar binary you intentionally want to use, set CODEXBAR_BIN.

cd ~/Work/codexbar-waybar
makepkg -si

The package downloads CodexBar CLI from GitHub releases and installs:

• /usr/bin/codexbar
• /usr/lib/codexbar-waybar/CodexBarCLI
• /usr/bin/codexbar-waybar
• /usr/bin/codexbar-waybar-install
• /usr/bin/codexbar-waybar-uninstall
• /usr/share/codexbar-waybar/waybar/codexbar.jsonc
• /usr/share/codexbar-waybar/waybar/codexbar.css
• /usr/share/codexbar-waybar/waybar-tooltip.jq

After installing the package:

codexbar-waybar-install

The installer updates ~/.config/waybar/config.jsonc and ~/.config/waybar/style.css by:

1. adding an include for /usr/share/codexbar-waybar/waybar/codexbar.jsonc
2. adding custom/codexbar to modules-right immediately after Omarchy's group/tray-expander when present
3. importing /usr/share/codexbar-waybar/waybar/codexbar.css
4. reloading Waybar with SIGUSR2

Backups are created before changes.

To install into another section:

codexbar-waybar-install --section modules-left
codexbar-waybar-install --section modules-center
codexbar-waybar-install --section modules-right

Useful options:

codexbar-waybar-install --dry-run
codexbar-waybar-install --after group/tray-expander
codexbar-waybar-install --after ''       # prepend if you do not want target placement
codexbar-waybar-install --no-css
codexbar-waybar-install --no-reload
codexbar-waybar-install --config-dir ~/.config/waybar

Run this before uninstalling the package:

codexbar-waybar-uninstall

It removes the module from the configured section, removes the include, removes the CSS import, and reloads Waybar.

You can test without installing to /usr:

cd ~/Work/codexbar-waybar
CODEXBAR_WAYBAR_FILTER="$PWD/share/codexbar-waybar/waybar-tooltip.jq" \
  ./bin/codexbar-waybar | jq .

To test the installer against the repo snippets:

CODEXBAR_WAYBAR_SHARE_DIR="$PWD/share" ./bin/codexbar-waybar-install --dry-run

The module reads these environment variables:

The installed include defines:

{
  "custom/codexbar": {
    "exec": "codexbar-waybar",
    "return-type": "json",
    "interval": 1800,
    "format": "{}",
    "escape": false,
    "tooltip": true
  }
}