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.