pafloxy

Agent Battery — Design skill for Claude Code

Design community

Battery like visual for agent usage quota.

How to install Agent Battery

This entry records only its repository, not the path inside it, so there is no exact command to give. Open pafloxy/agent-battery and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Agent Battery does

Battery like visual for agent usage quota. Works with Codex/Claude

Alternatives in Design

Od Contribute — Open a first-contribution PR (or bug issue) on nexu-io/open-design — works for non-coders too 91.8k ★
CloudCLI — 8,400+ Free open-source web/mobile UI for Claude Code, Cursor CLI, and Codex 8.7k ★
Companion — 2,200+ Web & mobile UI for Claude Code & Codex 2.2k ★

README

Agent Battery

Agent Battery shows coding-agent usage in a compact GNOME panel or a terminal command. It uses the provider CLI already signed in on your computer. No Agent Battery account, daemon, Python package installation, or administrator access is required.

![Illustrative Agent Battery panel and first-click dropdown](docs/assets/agent-battery-explainer.svg)

The green battery fill is the provider-reported allowance remaining. The blue line and reset column show time remaining in that reported window. The first-click menu lists the general Codex pool first, then named model pools such as `GPT-5.3-Codex-Spark`; a reported 5-hour window appears there beside its own weekly window. An elapsed reset time never turns into a full battery until a fresh provider read confirms it.

How It Works

flowchart LR
    U[You] --> I[GNOME panel or terminal]
    I --> H[Agent Battery local helper]
    H --> C[Installed provider CLI]
    C --> S[Provider account service]
    S --> C --> H --> I

Agent Battery makes one short status read through the provider CLI. It starts no coding task and sends no data to another monitoring service. The helper keeps only a sanitized quota snapshot for the GNOME display; the provider CLI owns login.

Quick Start

From this extracted folder:

python3 -m agent_battery --demo
python3 -m agent_battery --doctor

The demo is synthetic and does not contact a provider. The doctor reports whether the `codex` and `claude` commands are available on your PATH without running them.

After signing in through the provider's own CLI, read usage once:

python3 -m agent_battery --provider codex
python3 -m agent_battery --provider codex --format json
python3 -m agent_battery --provider claude

On Windows, use `py -3` in place of `python3`. Python 3.10+ is required. The terminal command works wherever Python and the selected provider executable work. It reads once and exits; it does not install a background process.