claudeers.
// Claude Plugins

claude-statuspane

A floating status card for Claude Code — model, context, rate limits, cost, branch — plus a progress API any script or mod can feed.

Actively maintained
99/100
last commit about 1 month ago
last release about 1 month ago
releases 9
open issues 0
// star history

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up claude-statuspane (claude-plugin project) into my current project.
Found on https://claudeers.com/claude-statuspane
Repo: https://github.com/xuanji86/claude-statuspane
Homepage/docs: https://github.com/xuanji86/claude-statuspane
Detected install method: claude-plugin → /plugin install claude-statuspane@xuanji86/claude-statuspane
Category: plugins. Platforms: cli, api, desktop.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or install directly (claude-plugin)
/plugin marketplace add xuanji86/claude-statuspane
/plugin install claude-statuspane@xuanji86/claude-statuspane
// or clone
git clone https://github.com/xuanji86/claude-statuspane

// compatibility

Platformscli, api, desktop
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageTypeScript

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

statuspane

A floating status card for Claude Code.
Model, context, rate limits, cost and branch at a glance, your GitHub CI and deploys, plus progress bars any script can feed.

English · 中文

The status card above the Claude Code prompt

Why

Claude Code's statusLine is one line of text from a shell script. statuspane is a mod: a small card that lives just above the prompt, reads Claude Code's own session figures, and can be clicked — no script to write.

Features

Model · effortThe model in use, whether Claude is working, and its reasoning effort on a gauge (▮▮▮▯▯ high)
ContextA gauge with tokens used / window (▰▰▰▱▱▱ 42% 222k/1M), and ⟲ compact: press, then confirm, to run /compact (after the turn, if Claude is working)
Rate limits5-hour and 7-day use, each on a small gauge, with reset countdowns (↻2h41m)
Where you areDirectory and git branch, shortened so the card stays narrow
Session costWhat this session has cost so far
GitHub CIThe branch's latest Actions run and the runs a push sets off, deploys included (GitHub CI)
Progress rowsBars any script or mod can feed, refreshed every second (Progress API)
ClickableHide, show and settings are buttons; everything works with the mouse
SettingsPick the lines you want and the bar width; one set for every session, a change shows in the others within 2 seconds

It is drawn in Claude Code's own theme colors, so it follows dark, light and colorblind themes: gauges in Claude's accent, turning to the theme's warning color from 60 % and its error color from 85 % (context: 50 % / 80 %).

Install

Needs Claude Code 2.1.287 or later, the release that brought mods (function hooks); tested on 2.1.300. Mods are early access: their API may change between releases, and a release that breaks the card gets a fix here.

/plugin marketplace add xuanji86/claude-statuspane
/plugin install statuspane@claude-statuspane
From a terminal instead
claude plugin marketplace add xuanji86/claude-statuspane
claude plugin install statuspane@claude-statuspane

The card appears in terminals at least 70 columns wide; the desktop app shows none, since it has its own, and a session only the desktop app draws, or none, polls nothing (no git, no gh). It adds to your setup and replaces nothing: a configured statusLine keeps showing; delete it from ~/.claude/settings.json if you want the card alone.

Use

Settings — click ⚙

The settings page

Click a line to switch it, [ - ] / [ + ] for the bar width (6–24), then ✓ Done.

Hidden — click ▾ hide

The card folded to one button

One button stays at the right edge; click ◂ status to bring the card back. /statuspane does the same from the prompt.

Tip: the - at the panel's corner, and a one-key shortcut

The - at the top right of the panel is Claude Code's own "hide plugin panel". It hides the whole panel, and only its keybinding brings it back (default ctrl+x ctrl+a). If your terminal doesn't pass ctrl+x chords through, bind it to one key in ~/.claude/keybindings.json:

{
  "bindings": [
    { "context": "Chat", "bindings": { "ctrl+s": "abovePrompt:toggle", "ctrl+q": "chat:stash" } }
  ]
}

ctrl+s is "stash" by default, so the example moves stash to ctrl+q.

GitHub CI

Two switches on the settings page, both off until you turn them on. They need the GitHub CLI signed in (gh auth login).

SwitchShows
CI · this branchThe latest Actions run of the branch the session is on: checked every minute, every 10 seconds while it runs
CI · after a pushWhen Claude runs git push or gh pr merge, the runs that set off (for a merge, on the base branch) until they finish; the result stays for 10 minutes

Each row reads <repo> <branch> and then:

⟳ test · 1m20saccent: under way, with the jobs running now and the time so far (ticks every second between checks)
⟳ deploying · 1m20sa job whose name has deploy in it is running
✓ deployed · 3m agogreen: done, and a deploy job succeeded (✓ passed when none ran)
✗ test failed · 3m agored: the job (or workflow) that failed
⊘ cancelled · 3m agoevery run was cancelled or skipped

All of one commit's workflows make one row; scheduled runs are left out.

Progress API

Show your own progress on the card, from any language or from another mod. Rows are sorted by id, at most five show, and each one goes away by itself once its source stops reporting. The card reads the 20 most recently written files, so old files left behind never crowd out a new one.

From any script: a JSON file

Write ~/.claude/statuspane/progress/<id>.json (the folder can be moved with STATUSPANE_PROGRESS_DIR, an absolute path or one starting with ~/):

{ "label": "build", "percent": 42.5, "text": "3/7 · 1.2/min", "ttl": 300, "state": "running" }
FieldType
labelstringShown before the bar, up to 24 characters (defaults to the id)
percentnumber, optional0–100. Leave it out for a text-only row
textstring, optionalShown after the bar, up to 60 characters
ttlseconds, optionalHow long the row stays after the file was last written (default 300)
statestring, optionalrunning (accent), ok (green) or error (red): colors the gauge and the text

<id> uses letters, digits, ., _ and -. Write to a temporary file and rename it over the target so the card never reads half a file; delete the file to remove the row at once.

Ready-made helpers in examples/ (they check the id, cut fields to length and write atomically; the shell one needs python3):

examples/report-progress.sh build "build" 42.5 "3/7"            # id label [percent] [text] [ttl] [state]
from report_progress import report, clear
report("my-job", "my job", 40, "4/10", state="running")
clear("my-job")

From another mod: $.statuspane

List statuspane under dependencies in your mod's plugin.json (its types are then laid into your .claude-plugin/types/statuspane/), and call:

await $.statuspane.progress({ id: 'my-job', label: 'my job', percent: 40, text: '4/10', ttl: 120, state: 'running' })
await $.statuspane.clear('my-job')

Same fields as the file. Rows from a mod live in memory, so report again after statuspane reloads.

Already reporting

  • ainiee-translate v1.14+ — progress --watch / --line show translation progress.

Privacy and safety

Its footprint, as the awesome-claude-code-mods scan reads it from claude plugin validate:

Everything stays on your machine. statuspane reads Claude Code's own session figures, runs git branch --show-current in the session's directory, and lists the progress folder. Only with a CI switch on does it reach out: it reads the origin remote and runs gh run list / gh run view (and gh pr view after a merge) for that repository, through gh and your own sign-in. From that folder it reads only *.json files of at most 64 KB, strips control, bidi and zero-width characters from their text, cuts every field to length, and never runs anything they contain.

Develop

git clone https://github.com/xuanji86/claude-statuspane
cd claude-statuspane
claude plugin validate .
claude plugin test .
claude --plugin-dir .        # or add the folder to CLAUDE_CODE_PLUGIN_DIRS

A session that loaded the mod from its folder reloads it each time you save a file. Issues and pull requests are welcome.

License

MIT © Anji Xu

// faq

What is claude-statuspane?

A floating status card for Claude Code — model, context, rate limits, cost, branch — plus a progress API any script or mod can feed.. It is open-source on GitHub.

Is claude-statuspane free to use?

claude-statuspane is open-source under the MIT license, so it is free to use.

What category does claude-statuspane belong to?

claude-statuspane is listed under plugins in the Claudeers registry of Claude-compatible tools.

24 views
★ 19 stars
unclaimed
updated about 1 month ago

// embed badge

claude-statuspane on Claudeers
[![Claudeers](https://claudeers.com/api/badge/claude-statuspane.svg)](https://claudeers.com/claude-statuspane)

// retro hit counter

claude-statuspane hit counter
[![Hits](https://claudeers.com/api/counter/claude-statuspane.svg)](https://claudeers.com/claude-statuspane)

// reviews

// guestbook

0/500

// related in Claude Plugins

🔓

A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.

// pluginsmultica-ai/★ 230,631[ claude ]
🔓

Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explainin…

// pluginsanthropics/⟨Python⟩★ 154,558[ claude ]
🔓

"CLI-Anything: Making ALL Software Agent-Native" -- CLI-Hub: https://clianything.cc/

// pluginsHKUDS/⟨Python⟩★ 58,467◷ Apache-2.0[ claude ]
🔓

financial-services — a Claude ecosystem project on GitHub.

// pluginsanthropics/⟨Python⟩★ 41,027◷ Apache-2.0[ claude ]
→ see how claude-statuspane connects across the ecosystem