GitHub リポジトリ · 投稿者 Gooner44

usage-bar

Name: usage-bar
Author: Gooner44

Claude Code プラグイン。プロンプトの上に、セッション（5時間）、週次（7日間）、モデルごとの使用率、メーター、リセット時間を表示するバンドを追加します。さらに、実行中のすべてのセッションとエージェントを表示するコンパニオンのスタッフボードプラグインも含まれています。

Gooner44@Gooner44

Gooner44/ClaudeMods/tree/main/plugins/usage-bar

翻訳済み

この mod について

ClaudeMods プラグインマーケットプレイスとしてパッケージ化された usage-bar は、Claude Code の hooks-module プラグイン API（2.1.286 をベースに構築）を使用して、プロンプトの上にバンドをレンダリングし、プランの制限のうちどれだけ使用したかを表示します。セッション（5時間ウィンドウ）、週次（7日間ウィンドウ）、および Fable 5.1 のようなモデルごとの週次ウィンドウです。それぞれ、パーセンテージ、メーター、リセット時間（米国中部時間）が表示されます。メーターは70%から琥珀色に、90%から赤色に変わり、テキストラベルも表示されるため、状態は色だけに依存しません。デスクトップアプリは実線バーを描画し、ターミナルは細い線を描画します。使用状況の数値はサブスクリプションログインが必要で、最初の返信後に表示されます。同じマーケットプレイスでは staff-board も提供されており、PC 上のすべての Claude Code セッションを表示します。これには、各セッションの現在のタスク、アクティブなツール呼び出し、モデル、実行中のエージェントが含まれ、ピクセルアートのキャラクター、ステータスライン、および /staff テキストビューが付属しています。

インストール

まず作者の README で marketplace とプラグイン名を確認してください。コマンドはリポジトリの構成によって変わる場合があります。

claude plugin marketplace add Gooner44/ClaudeMods
claude plugin install usage-bar

原文 / README

ClaudeMods

Mods for Claude Code, packaged as a plugin marketplace.

Install

/plugin marketplace add Gooner44/ClaudeMods
/plugin install usage-bar@claude-mods
/plugin install staff-board@claude-mods

Or try one without installing:

claude --plugin-dir path/to/ClaudeMods/plugins/usage-bar

These use Claude Code's hooks-module plugin API (built on 2.1.286); older versions won't load them.

Plugins

usage-bar

A band above the prompt showing how much of your plan's limits you've used:

Session: the 5-hour window
Weekly: the 7-day window
Fable 5.1: a per-model weekly window, when your plan reports one (otherwise "no reading yet")

Each shows the percentage, a meter, and when it resets (times in US Central). The meter turns amber from 70% and red from 90%, with a "Nearing limit" / "At limit" label so the state never relies on color alone.

On the desktop app the meters are solid bars; in the terminal they're thin ━━━─── lines. Usage figures need a subscription login and appear after the first reply.

staff-board

See every Claude Code session running on this PC, such as Claude, Aesop and background jobs: what each is working on, what it's doing right now, and the agents it has running.

The band above the prompt: a little Clawd character for every session and every agent it's running. A character walks while it works and stands (blinking now and then) while idle. Next to each one:
- its name and state (working for how long, or idle)
- its job: the session's current task, or the agent's task description
- the tool it's calling right now
- the model, or which session an agent belongs to
This session comes first, then Claude, Aesop and the others, then background jobs. The band sits under usage-bar's meters when both are installed. Collapse it with [-] or ctrl+x ctrl+a.
Status line: the other sessions at a glance, e.g. Aesop working · 1 agent | 2 jobs.
/staff: posts the same board as text. Remote Control on the phone draws no band, so this is the phone's view.

The characters are pixel art in the terminal. The desktop app shows a small block glyph instead.

How it works: each session writes a small card to ~/.claude/staff-board/<session id>.json every few seconds, and reads everyone else's. A card that hasn't been updated for 90 seconds counts as closed. Sessions are named by the CLAUDE_STAFF (or CLAUDE_TASK) environment variable; unnamed ones show as Session <id>. Background (-p) runs write their card but don't read the board.

Old cards stay in the folder (they're ignored once stale); delete the folder's contents any time.