dms-codexbar

A DMS (Dank Material Shell) plugin for monitoring AI provider usage quotas. Wraps the CodexBar CLI to display Claude, Codex, Gemini, Copilot, and other AI usage directly in your DankBar.

Screenshot

Features

• Bar pill showing highest-usage provider with color-coded percentage (green/yellow/red)
• Click-to-expand popout with all providers
• Per-provider session, weekly, and tertiary usage bars with animated fills
• Reset countdown timers
• Credits display
• Configurable refresh interval, binary path, and source mode
• Auto-detects codexbar CLI from PATH, ~/.local/bin, or /usr/local/bin

Requirements

• DMS (Dank Material Shell) on Quickshell 0.2+
• CodexBar CLI binary installed

Installation

1. Install CodexBar CLI

Download the latest release for your platform:

# Using gh CLI
gh release download --repo steipete/CodexBar --pattern 'CodexBarCLI-*-linux-x86_64.tar.gz'
tar xzf CodexBarCLI-*-linux-x86_64.tar.gz
install -m 0755 CodexBarCLI ~/.local/bin/codexbar

Verify it works:

codexbar usage --format json --provider both --source oauth

2. Install the plugin

Option A: Install script

git clone https://github.com/zakstam/dms-codexbar.git
cd dms-codexbar
./install.sh

Option B: Manual

mkdir -p ~/.config/DankMaterialShell/plugins/CodexBar
cp plugin.json CodexBarWidget.qml CodexBarSettings.qml \
   ~/.config/DankMaterialShell/plugins/CodexBar/

Option C: Symlink (for development)

ln -s "$(pwd)" ~/.config/DankMaterialShell/plugins/CodexBar

3. Enable in DMS

1. Restart Quickshell
2. Open DMS Settings > Plugins
3. Enable CodexBar
4. Add the widget to a DankBar section (left/center/right) in DMS Settings > DankBar

Configuration

All settings are available in DMS Settings > Plugins > CodexBar:

Setting	Default	Description
Refresh Interval	2 minutes	How often to poll the CLI (1m / 2m / 5m / 15m / 30m)
Binary Path	(auto-detect)	Path to codexbar executable
Source Mode	oauth	Data source: oauth (recommended), cli, or api

Source modes

• oauth (recommended): Uses Claude/Codex OAuth tokens. Works reliably for all providers on Linux.
• cli: Uses PTY probe to read usage from CLI tools directly. May timeout for Claude on newer versions.
• api: Fetches usage via API tokens. Requires API key configuration in CodexBar.

How it works

The plugin runs codexbar usage --format json --provider both --source <mode> at the configured interval, parses the JSON output, and displays:

• Bar pill: Highest-usage provider name + session percentage, color-coded by threshold
• Popout: All providers with session/weekly/tertiary usage bars, reset countdowns, login method, credits, and account info

License

MIT