Omahub
← All plugins
R

Agent Usage

by Rob Zolkos

Weekly Claude and Codex usage, reset countdowns, and prorated pace in the Omarchy bar.

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
4aa2583
Scanned
2 weeks ago

No potentially dangerous behavior detected in the analyzed commit.

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

None
AI risk level
None
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
4aa2583
Reviewed
2 weeks ago

The plugin is a simple bar widget that displays Claude and Codex usage by running two fixed external collector commands and parsing their JSON output. The code is straightforward, contains no obfuscation, no credential handling, no destructive operations, and no unexpected network or file activity. The deterministic scan found no issues, and my review agrees.

How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/robzolkos/omarchy-agent-usage --enable
Widgets #bar #quickshell #ai

Agent Usage for Omarchy

An Omarchy bar plugin that keeps weekly Claude and Codex usage visible without opening a panel.

Agent Usage panel for Omarchy

What it shows

Each provider displays its weekly allowance used and the time until reset directly in the bar:

Claude 31% · 16h  Codex 18% · 4d 22h

A provider turns red when its usage exceeds the prorated portion of its seven-day window. For example, with 70% of the week elapsed, 76% used is behind pace while 58% used is ahead.

Click the bar display for detailed meters, expected remaining allowance, pace difference, a seven-day token chart, and additional limit windows. Right-click or middle-click to refresh immediately.

Requirements

  • Omarchy with Quickshell plugin support.
  • Authenticated Claude Code and Codex CLIs.
  • Omarchy's omarchy-agent-usage-claude and omarchy-agent-usage-codex collectors.

The plugin runs each collector with --limits-only. It uses the credentials already managed by the provider CLIs and does not read or store credentials.

Installation

omarchy plugin add https://github.com/robzolkos/omarchy-agent-usage.git --enable

For a local checkout:

omarchy plugin add ~/code/robzolkos/omarchy-agent-usage --enable

Disable Omarchy's built-in Agents display if both widgets appear:

omarchy plugin disable omarchy.agents

Usage

  • Left-click the bar display to open or close details.
  • Right-click or middle-click to refresh.
  • Press R while the panel is open to refresh.
  • Press Escape to close the panel.

The plugin refreshes every five minutes by default. Change the interval with:

omarchy bar set robzolkos.agent-usage refreshIntervalSec 600 --json

Removal

Remove the plugin with:

omarchy plugin remove robzolkos.agent-usage

Restore Omarchy's built-in Agents display if desired:

omarchy plugin enable omarchy.agents

License

MIT