English | 简体中文
Native Omarchy Quattro panel, Waybar widget, and tabbed TUI for AI plan usage across Claude, Codex/ChatGPT, Z.AI (GLM), OpenRouter, DeepSeek, Kimi, OpenCode Go, and other supported AI coding services.
ai-usagebar-omarchy began as a Rust port of
claudebar and remains drop-in
compatible. It keeps claudebar's Pango tooltip, Omarchy theme detection, and
flock-protected OAuth refresh while adding more providers and a testable Rust
codebase.
- Z.AI / BigModel enterprise (team) subscription keys: the same monitor
endpoint with
?type=2plus organization/project headers — configure the billing type per key and the site (z.ai / bigmodel.cn) is auto-detected from it. Pay-as-you-go keys degrade to 7-day usage stats automatically. - Multi-account for every key-based vendor (
[[zai.accounts]],[[kimi.accounts]],[[openrouter.accounts]],[[deepseek.accounts]], …): every key gets its own tile on the bar, its own TUI tab, and an isolated cache — manage them in the native settings form (per-vendor groups, add / delete, per-card Apply) or inconfig.toml. Accounts are auto-named by their position in the list (1, 2, …): no name to configure, and--account 2selects the second one. - OpenAI platform spend (
[openai_api]): trailing-30-day billed dollars from the Costs API over an organization Admin key — the OpenAI twin of the Anthropic API vendor, with an optional monthly limit per account. Regular projectsk-keys are rejected by these endpoints. - Per-figure range colors on the bar: each window figure (5h, weekly)
is its own Text object colored by ITS remaining band — green ≥50%,
yellow <50%, orange <20%, red <5% — so a green 5h figure can sit beside
an orange weekly one in the same tile; the account tag always stays
neutral (theme foreground, never changes with usage). Windows show their
own reset countdowns (
42%·2h 05m 15%·2d 3h,0%·-for windows not started yet). - Per-provider Waybar modules use the same JSON shape and flags as claudebar.
- The native Omarchy Quattro plugin follows the shell theme and supports keyboard navigation, provider switching, live reset timers, and stale/error states.
ai-usagebar-omarchy-tuiopens with a compact provider overview and refreshes every 60 seconds. Its navigation can use a sidebar, navbar, or no vendor box.- An optional Claude Code context view reads recent local session usage without scanning entire histories.
- The native Omarchy Quattro plugin is the primary frontend.
- One bar item tiles every enabled account at once (
--vendor allfor Waybar; the Omarchy bar does it natively).[ui] primarycontrols the initial provider in the widget and TUI. Exhausted accounts (every window maxed, or a balance at zero) leave the bar until their next report shows room again — the tabs and hover popup keep them. - Bar tiles carry each vendor's logo and compact one-unit countdowns
(
5.3h,2.3d); tooltips and panels keep the detailed2h 05mform. - Atomic caches and file locking prevent duplicate requests from multi-monitor Waybar setups.
- Network failures keep the previous data visible; HTTP errors appear in the tooltip.
--pretty,--watch N, andmake smokehelp with local testing and API response changes.
Two steps:
# 1. install the CLI binaries from source
cargo install --git https://github.com/KyleLee/ai-usagebar-omarchy
# 2. install the plugin
omarchy plugin add https://github.com/KyleLee/ai-usagebar-omarchy.git --enableStep 1 compiles from source. On Arch-based systems your AUR helper can install the same thing without a local clone:
yay -S ai-usagebar-omarchy # or your AUR helper of choice (paru, …); builds from source
yay -S ai-usagebar-omarchy-bin # prebuilt binaries from the GitHub ReleasesAnywhere with Rust, cargo binstall ai-usagebar fetches those same release
binaries instead of compiling (install the helper once with
cargo install cargo-binstall).
No Rust yet? Install it from https://rustup.rs first — cargo install
builds both ai-usagebar-omarchy and ai-usagebar-omarchy-tui into
~/.cargo/bin (make sure that directory is on your session PATH so the
Omarchy shell can find the binary). Update later by re-running the same
command with --force. The AUR packages and cargo binstall also drop both
binaries on your PATH.
Optionally hide the stock Agents widget to avoid duplicates:
omarchy plugin disable omarchy.agentsThat's it — the bar immediately tiles every configured account (right-click
launches the TUI; cargo installed it too). Nothing configured yet? Click the
bar icon → gear (s) → ACCOUNTS → Add account → pick the provider
(Z.AI / Kimi) → paste the API key → Apply — that is all an account needs.
It is auto-named by its position in the vendor's list (1, 2, …), and
--account 2 selects the second one. Z.AI team keys also select the team
billing type and paste the two organization ids; the site
(z.ai / bigmodel.cn) is auto-detected from the type.
Left-click the widget opens the native Quattro panel; middle-click / wheel
switches providers. The first run also drops a fully commented template at
~/.config/ai-usagebar-omarchy/config.toml (mode 0600, never rewritten) —
editing it and the settings form are interchangeable.
Update/remove the plugin with omarchy plugin update ai-usagebar-omarchy /
omarchy plugin remove ai-usagebar-omarchy.
Claude and Codex reuse OAuth credentials from their official CLIs. Other
providers use API keys, an existing app login, or a local service. API keys can
come from environment variables or config.toml.
| Vendor | Method | Action required |
|---|---|---|
| Claude | OAuth from ~/.claude/.credentials.json or the macOS login Keychain |
Run claude once. Tokens refresh automatically. |
| Anthropic API | Organization Admin key | Opt in with ANTHROPIC_ADMIN_KEY or [anthropic_api] api_key. Inference and Claude Code keys do not work. Extra Admin keys via [[anthropic_api.accounts]], each with its own optional monthly_limit. |
| Codex | OAuth, read from ~/.codex/auth.json |
Run codex login once. Token auto-refreshes. |
| Z.AI | API key (ZAI_API_KEY env or [zai] api_key in config) |
Set either. Team/enterprise coding-plan keys work too: set account_type = "team" with organization_id + project_id (see the configuration reference). Multiple keys via [[zai.accounts]]. |
| OpenAI API | Organization Admin key | Opt in with OPENAI_ADMIN_KEY or [openai_api] api_key. Trailing-30-day spend from the Costs API; regular project sk- keys are rejected. Extra keys via [[openai_api.accounts]], each with its own optional monthly_limit. |
| DeepSeek | API key (DEEPSEEK_API_KEY or config) |
Set either and opt in. Extra keys via [[deepseek.accounts]]. |
| Kimi | Existing Kimi Code CLI login or API key (KIMI_API_KEY or config) |
Opt in, then either log in with kimi (nothing to paste) or set an API key, which wins when present. A Kimi For Coding subscription can issue one at kimi.com/code/console. Extra subscriptions via [[kimi.accounts]]. |
| Kilo | API key (KILO_API_KEY env or [kilo] api_key in config) |
Set either. Opt-in. For a team balance, also set [kilo] organization_id; omit it for the personal balance. Extra keys via [[kilo.accounts]]. |
| Novita | API key (NOVITA_API_KEY env or [novita] api_key in config) |
Set either. Opt-in. Extra keys via [[novita.accounts]]. |
| Moonshot | API key (MOONSHOT_API_KEY or config) |
Opt in. Set region cn for CNY; global uses USD. Extra keys via [[moonshot.accounts]]. |
| Grok (xAI) | Management key | Opt in with XAI_MANAGEMENT_KEY or config. An inference key does not work. Extra keys via [[grok.accounts]]. |
| SuperGrok | Official Grok Build ACP extension | Opt in, install Grok Build, and run grok login. This reports subscription usage, not the Management API balance. |
| MiniMax | Token Plan subscription key | Opt in with MINIMAX_API_KEY or config. Choose the matching global or China region; pay-as-you-go keys do not work. Extra keys via [[minimax.accounts]]. |
| Google Antigravity | Local Antigravity server | Opt in and keep Antigravity or an interactive agy session running. |
| Cursor | Existing Cursor IDE or cursor-agent login |
Opt in and sign in once. cursor-agent is the headless fallback. |
| Kiro CLI | Existing kiro-cli login | Opt in and run kiro-cli login once. ai-usagebar-omarchy refreshes the session when needed. |
| OpenCode Go | API key (OPENCODE_GO_API_KEY env or [opencode-go] api_key in config) |
Enable [opencode-go], then enter the key in the Omarchy settings panel or set the environment variable. Extra keys via [[opencode-go.accounts]]. |
OpenCode Go uses the official usage endpoint and the percent field. Its key can
be entered through the native Settings panel; stored values are sent to the Rust
settings command over stdin and are never placed in QML command arguments. Cache
entries are tied to the endpoint and a one-way key fingerprint, so changing
accounts cannot reuse another account's fresh or stale usage.
The balance lives at /v1/billing/teams/{team}/prepaid/balance, so a team has to
be identified. With a team-scoped management key the team is read
automatically from the key. An organization-scoped key cannot provide it
because that key's scopeId is an organization id rather than a team. Set the
team explicitly in that case:
[grok]
team_id = "your-team-id"Without it, an organization-scoped key reports an error saying exactly this rather than silently querying the wrong URL.
enabled = true is what makes a vendor fetch. Anthropic API, DeepSeek, Kimi,
Kilo, Novita, Moonshot, Grok, SuperGrok, Antigravity, Cursor, MiniMax, and Kiro CLI all default to disabled so that existing
installs are unaffected until you opt in. Use either method:
- Use the gear or
sin the Omarchy panel, or runai-usagebar-omarchy-tuiand presss. Saving a non-empty API key sets that vendor'senabled = truefor you. Clearing it removes the inline key fromconfig.toml. - Add
enabled = trueto the vendor's config section alongside the key.
The primary-vendor selector only offers vendors that are currently enabled, so a vendor you haven't opted into cannot be set as primary.
Vendors that authenticate through a local login rather than a key — Cursor,
Kiro CLI, SuperGrok, Antigravity, and Kimi when you have a Kimi For Coding
subscription — have no key to save, so enable them with enabled = true in
config.toml.
For each API-key vendor, ai-usagebar-omarchy checks in this order:
- A non-empty environment variable named by
api_key_env. - An inline
api_keyin the same config section. - An error that names both missing options.
- Inline keys belong in
~/.config/ai-usagebar-omarchy/config.tomlat mode600. Redact them before committing that file to dotfiles. Environment variables remain the default and avoid storing keys in the config. - Claude and Codex credentials stay in files managed by their official CLIs.
- SuperGrok credentials stay inside Grok Build. ai-usagebar-omarchy receives a credential-free billing result and hashes auth/config files only to separate caches between logins.
- Cursor's
state.vscdbandcursor-agentfallbackauth.jsonare read-only. - kiro-cli's
data.sqlite3is read-only. Refreshed credentials go to an account-scopedkiro/oauth.jsonfile, mode600on Unix.
Recent Claude Code builds store OAuth credentials in the macOS login Keychain
instead of ~/.claude/.credentials.json. No setup is needed: ai-usagebar-omarchy uses
macOS's security tool to read and refresh the Claude Code-credentials item.
- The default account still uses an existing credentials file when one is present.
- Each scoped
CLAUDE_CONFIG_DIRlogin gets its ownClaude Code-credentials-<hash>Keychain item. - Named accounts use the scoped Keychain item on macOS and fall back to their credentials file on Linux.
The optional config file is ~/.config/ai-usagebar-omarchy/config.toml.
Claude, Codex, Z.AI, and OpenRouter are enabled by default; other providers
are opt-in.
Upgrading from the pre-rename layout (~/.config/ai-usagebar/)? The first
run moves the whole directory — config, credentials, accounts — to the new
name (a mode-preserving copy when a rename is impossible; nothing is
deleted), so this fork and the upstream ai-usagebar-omarchy it forked from stop
sharing state. A config that could not be migrated is still read in place.
No setup needed to start: the first run (widget, TUI, usage, or the
Omarchy panel's refresh) drops a fully commented template at that path —
every section and field explained inline, mode 0600, nothing enabled beyond
the defaults — so configuring is filling in the blanks. It is never
rewritten once it exists.
A minimal example:
[ui]
primary = "openai"
[kimi]
enabled = true
# api_key = "..." # or set KIMI_API_KEYSee the configuration reference for every provider, display option, account path, region, and API-key setting.
Native frontends do not parse your config.toml themselves; they go through
two administrative subcommands:
# Non-secret JSON description of the current settings: the primary vendor
# and which key fields each vendor offers. Never prints a key.
ai-usagebar-omarchy settings show
# Apply one JSON patch read from standard input — keys never appear in argv
# or the process environment.
echo '{"schema_version":1,"keys":{"kimi":{"action":"set","value":"..."}}}' \
| ai-usagebar-omarchy settings applyA patch carries an optional primary vendor slug and a keys map; each key
entry is {"action":"set","value":…}, {"action":"clear"}, or
{"action":"fields","fields":{…}} for vendor-specific values (Z.AI team ids,
monthly limits). Saving a non-empty key also sets that vendor's
enabled = true, exactly like the TUI overlay.
An optional accounts map carries per-vendor account mutations:
{"action":"add"} (appends), {"action":"update","label":"2",…}, and
{"action":"remove","label":"2"}. label is the account's 1-based position
in the list as it was when the save started ("" is the vendor's default
card), so one patch may remove "1" and still edit "2" without the edit landing
on the wrong account; entries a patch appends sit behind every original
position. Clearing an account's key drops the entry when nothing else is left
in it — for the key vendors an account is its key — while entries that still
hold something (api_key_env, monthly_limit, Z.AI billing fields) survive.
This is the protocol the Omarchy settings form speaks; it edits the same
config.toml documented above, through the same toml_edit path.
# Local testing — auto-detects TTY and renders human-readable output.
ai-usagebar-omarchy # uses [ui] primary (defaults to anthropic)
ai-usagebar-omarchy --vendor anthropic_api
ai-usagebar-omarchy --vendor openai
ai-usagebar-omarchy --vendor zai
ai-usagebar-omarchy --vendor openrouter
ai-usagebar-omarchy --vendor deepseek
ai-usagebar-omarchy --vendor kimi
ai-usagebar-omarchy --vendor kiro
# Force Waybar JSON (e.g. piping into jq).
ai-usagebar-omarchy --json
# Everything at once: quota + time-to-reset for every configured vendor,
# with one entry per named Claude account.
ai-usagebar-omarchy usage
ai-usagebar-omarchy usage --json | jq '.entries[] | {id, metrics, sections}'
# Tile every enabled vendor AND account in one bar module — one compact
# tile per account (team 42% │ kmi 18% │ cld 5%), hover for the combined
# report. The taskbar equivalent of the GNOME extension's multi-account
# tiling.
ai-usagebar-omarchy --vendor all
# Live preview while iterating on --format / --tooltip-format.
ai-usagebar-omarchy --vendor openrouter --watch 5
# Interactive TUI with tabs.
ai-usagebar-omarchy-tuiThe JSON report has two views of each provider:
metricscontains percentage gauges only.sectionspreserves the complete ordered display, including balances, grouped rows, and spacers. Rows without a percentage do not invent one.
The report also includes the configured primary id. Each entry has
display_name, short_name, status, stale, and fetched_at; metric rows
may add severity and an absolute reset_at. These fields are additive, so
existing consumers remain compatible. short_name is the same three-letter
code {vendor_short} prints, so a frontend that wants a compact provider tag
takes it from the report instead of keeping its own table.
ai-usagebar-omarchy-tui ships with the same cargo install the bar uses
(and lands in the same ~/.cargo/bin):
cargo install --git https://github.com/KyleLee/ai-usagebar-omarchyNo Rust yet? Install it from https://rustup.rs first.
The TUI does not depend on Waybar. Run it directly in a local terminal, over SSH, or in a tmux pane:
ai-usagebar-omarchy-tui # opens in your current terminalIt works in Kitty, Alacritty, Foot, Ghostty, and other terminal emulators. The controls and Settings overlay are the same everywhere; no compositor or window manager integration is required.
The Omarchy Quattro plugin is the primary frontend: bar tiles per account with per-figure range colors, the native settings form, live reset countdowns, and stale/error states — see its README for controls and settings details.
Use one bar item and scroll through your vendors. The TUI on-click still shows them all:
{vendor_short} identifies the active provider with a three-letter code. For a
format shared by every cycled provider, use {session_pct},
{session_reset}, {weekly_pct}, and {weekly_reset}. Cursor maps its two
usage pools to the session and weekly slots; Kiro maps its single pool to both.
The placeholder reference lists every generic
and provider-specific field.
signal: 13 lets the scroll commands refresh the bar through SIGRTMIN+13
instead of waiting for the next interval.
The KDE plasmoid has the same gesture in its own settings and never reads or writes the state file this section relies on.
If a tray expander follows custom/aibar, the usage text may sit too close to
its icon. Add right padding in Waybar CSS:
#custom-aibar {
padding-right: 18px;
}If you'd rather see them all at once:
"modules-right": ["custom/claude", "custom/openai", "custom/openrouter", "custom/zai", "custom/deepseek", "custom/kimi"],
"custom/claude": {
"exec": "ai-usagebar-omarchy --vendor anthropic --icon ''",
"return-type": "json",
"interval": 300,
"tooltip": true,
"on-click": "ai-usagebar-omarchy-tui"
},
"custom/openai": {
"exec": "ai-usagebar-omarchy --vendor openai --icon ''",
"return-type": "json",
"interval": 300,
"tooltip": true
},
"custom/openrouter": {
"exec": "ai-usagebar-omarchy --vendor openrouter --icon '' --format '{or_balance} · {or_used_today}'",
"return-type": "json",
"interval": 600,
"tooltip": true
},
"custom/zai": {
"exec": "ai-usagebar-omarchy --vendor zai --icon ''",
"return-type": "json",
"interval": 300,
"tooltip": true
},
"custom/deepseek": {
"exec": "ai-usagebar-omarchy --vendor deepseek --icon ''",
"return-type": "json",
"interval": 600,
"tooltip": true
},
"custom/kimi": {
"exec": "ai-usagebar-omarchy --vendor kimi --icon ''",
"return-type": "json",
"interval": 600,
"tooltip": true
}Why 300s for Waybar? The Anthropic and OpenAI Codex endpoints are undocumented and rate-limit aggressively below ~300s. The cache TTL is 60s so multi-monitor instances coexist, but Waybar's polling interval should stay at 300s. (The Omarchy panel polls every 60s by default; Claude/Codex fetches are internally throttled to a 300s cache TTL there, so the fast poll only accelerates the other vendors.)
Two ChatGPT subscriptions, each its own login:
CODEX_HOME=~/.codex-work codex login[[openai.accounts]]
label = "work"
codex_auth_path = "~/.codex-work/auth.json"ai-usagebar-omarchy --vendor openai --account workEach account keeps its own cache and refreshes independently. Without
--account, the default codex_auth_path login is used exactly as before.
Named accounts appear as separate TUI tabs and report entries. The recommended setup is:
ai-usagebar-omarchy account add work
ai-usagebar-omarchy --vendor anthropic --account workOn macOS, the same account command can also capture and switch the active Claude Desktop or CLI login. The dedicated Claude account guide covers:
- explicit and auto-discovered accounts;
- safe credential and cache isolation;
- Waybar modules for personal and work subscriptions;
- macOS Desktop and CLI switching, backups, and history conflicts.
Add one [[vendor.accounts]] entry per extra key (works for OpenRouter,
DeepSeek, Kilo, Novita, Moonshot, Grok, MiniMax, OpenCode Go, Anthropic API,
OpenAI API, Z.AI and Kimi), then select it positionally:
--vendor openrouter --account 2. Accounts appear separately in the TUI,
native integrations, and usage reports; each has its own cache, so one
key's fresh data cannot be shown for another. See the
account guide for the config and Waybar
examples.
By default Hyprland tiles the TUI. To make ai-usagebar-omarchy-tui open as a centered floating window, the same way Omarchy floats its own settings TUIs (Wi-Fi/impala, audio/wiremix, Bluetooth/bluetui), add this to ~/.config/hypr/hyprland.conf or any sourced .conf, such as looknfeel.conf:
# ai-usagebar-omarchy TUI — float + center + fixed size. omarchy-launch-tui sets the
# app-id from the binary basename, so the class is org.omarchy.ai-usagebar-omarchy-tui.
# 875x600 matches the size Omarchy gives its own `floating-window`-tagged TUIs.
windowrule = float on, match:class ^(org\.omarchy\.ai-usagebar-omarchy-tui)$
windowrule = center on, match:class ^(org\.omarchy\.ai-usagebar-omarchy-tui)$
windowrule = size 875 600, match:class ^(org\.omarchy\.ai-usagebar-omarchy-tui)$Then hyprctl reload (no logout needed).
Omarchy tags a hardcoded list of TUI app-ids with
floating-windowin~/.local/share/omarchy/default/hypr/apps/system.conf, which then appliesfloat + center + size 875 600. The rules above set those values directly, so the size is deterministic regardless of which config is sourced first. If you launch the TUI differently (e.g.kitty -e ai-usagebar-omarchy-tui), replace the class regex with whateverhyprctl clientsreports for your terminal.
Hyprland 0.46+ uses the unified
windowrulekeyword withmatch:…filters. The olderwindowrulev2 = …, class:…syntax still works on legacy releases but is deprecated. Use the form above on current Omarchy and Hyprland.
The CLI and TUI support every provider in the authentication table above. Native desktop coverage varies by integration. The provider endpoint reference lists each endpoint, reported metric, desktop selector, stability note, and live-test command.
Run make smoke to check live response shapes.
Use placeholders in --format and --tooltip-format:
ai-usagebar-omarchy --vendor anthropic --format '{session_pct}% · {session_reset}'
ai-usagebar-omarchy --vendor openrouter --format '${or_balance} remaining'Shared claudebar placeholders and every provider-specific field are listed in the format placeholder reference.
ai-usagebar-omarchy --watch 5 # iterate on --format live
ai-usagebar-omarchy --vendor openrouter --format '{or_balance} · today {or_used_today}'
make test # unit + integration
source ~/.config/zsh/secrets # optional: load your real keys for smoke tests
make smoke # 21 live API smoke tests — every vendor skips itself when
# its credential is missing, so run it with the keys you have;
# a bogus key fails fast against the real endpoint
make clippy # cargo clippy -D warningsTab/l/→— next tabShift+Tab/h/←— previous tabr— refresh active tabR— refresh all tabss— open Settings overlay (primary vendor + API keys)c— open local Claude context sessions (only when[context] enabled = true);vcycles its layoutq/Esc/Ctrl-C— quit
The TUI refreshes every 60 seconds. During a refresh it keeps the current values
visible with a ↻ marker. If the request fails, the last snapshot remains on
screen and is marked stale.
OpenRouter uses the same layout for balance, usage by period, and account tier:
The optional context overlay answers a different local question from the
vendor tabs: how much input context was present in recent Claude Code sessions.
Enable it by hand, restart the TUI, and press c:
[context]
enabled = true
layout = "full" # full | split | bottom (`v` cycles)
# projects_path = "~/.claude/projects" # this is the default
# context_window_tokens = 200000 # optional fallback
# Exact model ids override the fallback when 200K and 1M sessions coexist.
[context.model_context_window_tokens]
"claude-opus-4-6" = 1000000The default full layout replaces the dashboard body. Press v to cycle
through full, split, and bottom layouts.
↑/↓orj/kselects a session.Enteropens its detail gauge.Escreturns andrrescans.
The percentage follows
Claude Code's status-line definition:
input_tokens + cache_creation_input_tokens + cache_read_input_tokens. Without
a trustworthy model window size, the overlay shows tokens instead of guessing
a percentage. After compaction, it waits for the next assistant response before
calculating a new value.
The reader handles Claude Code's undocumented local JSONL defensively:
- it reads bounded tails from the 100 most recently modified top-level sessions;
- it ignores corrupt records and
subagentssidechains; - it does not follow discovered symlinks;
- it performs filesystem work off the UI thread.
When the feature is disabled, nothing under ~/.claude/projects is read.
Context options remain in TOML rather than the Settings modal.
Press s while the TUI is open. The overlay lets you:
- Pick the primary vendor that the widget defaults to and that the TUI selects on startup. Use
←/→to cycle. - Enter a key for any supported API-key provider. Keys are masked as you type;
press
Ctrl-Vto reveal or hide them. The provider's configured environment variable still wins at runtime; the inline key is the fallback. Saving a non-empty key also sets that provider'senabled = true.
Key bindings inside the overlay:
Tab/↑↓— move between fields←/→— cycle primary-vendor selection (only on the vendor field)Ctrl-V— toggle key visibility on the focused key fieldCtrl-S— save and closeEsc— discard and close
Save updates ~/.config/ai-usagebar-omarchy/config.toml through toml_edit, preserving
comments and unrelated settings. The file is set to mode 600.
Omarchy's native QML form uses the same Rust persistence path and semantics. It never loads stored key values into the long-lived shell process: blank means unchanged, clear is explicit, and new values are sent to the binary over stdin.
After saving:
- TUI tabs fetch again immediately.
- Waybar modules configured with
signal: 13refresh throughSIGRTMIN+13. - Other Waybar modules refresh on their next interval. Run
pkill -SIGUSR2 waybarto force a full reload.
- One Dark palette by default.
- Auto-merges with the active Omarchy theme at
~/.config/omarchy/current/theme/colors.toml. - Per-color overrides:
--color-low,--color-mid,--color-high,--color-critical(claudebar-compatible). - Pacing calibers (claudebar-compatible):
--pace-tolerance <pp>widens or narrows the band (percentage points, default 5) for ratio-based pace icons;--format-pace-colorcolors each pace placeholder by its own window instead of the global usage color;--tooltip-pace-ptsswitches the tooltip's pace column to point-based pacing and adds an elapsed-position marker on its progress bars.
See CHANGELOG.md for the release history. Each release also has its own page at https://github.com/KyleLee/ai-usagebar-omarchy/releases with the auto-generated install snippet and checksum.
This repository is forked from
ai-usagebar by
AkitaOnRails — thanks for the original project.
The Codex and Claude OAuth endpoint references came from
claudebar and
codexbar, both by mryll. The bordered
Pango tooltip, severity colors, and pacing math also come from those projects.
The Kimi /coding/v1/usages endpoint reference came from community quota tools: CodexBar (steipete), OpenUsage, and OmniRoute.
MIT.




