A better Claude Code ribbon news update news update

Developer Kompas released an overhaul of ribbon, an open-source terminal usage band for Anthropic's Claude Code command-line interface originally built by Jay E of RoboNuggets. As outlined in blog.hagebols.com's report, the new Kompas/ribbon fork resolves account desynchronization, corrects pricing table calculations, and adds native configuration options directly inside Claude Code.

This release targets developers and engineers running Claude Code across multiple organizational accounts, pay-as-you-go API keys, or local offline models. It details how the fork monitors active tokens, tracks five-hour and weekly reset windows, eliminates terminal display clipping, and aligns status metrics with official Anthropic pricing.

01What shipped in A better Claude Code ribbon news update

The Kompas/ribbon fork delivers automatic account and organization identification directly from Claude Code configuration files. Instead of preserving stale usage figures across session restarts, the status ribbon queries the internal usage endpoint immediately upon launch. Users open new sessions and instantly observe their remaining weekly allotment and reset countdown before transmitting their first prompt.

The fork incorporates unresolved pull requests from the original RoboNuggets repository, integrating patches from issues #3, #8, #14, and #17 alongside pull requests #2, #4, and #7. The original animated robot indicator, prompt cache tracking routines, and core window calculations from Jay E remain fully operational.

The update also introduces alternative operational modes for non-subscription environments. When authenticated with an API key, the status band displays accumulated session costs rather than subscription percentages. For local models, the ribbon suppresses Anthropic cache telemetry and presents the active model name alongside real-time context window consumption.

02What improved in A better Claude Code ribbon news update

The developer corrected three erroneous pricing calculation rows that previously miscalculated token expenses against official Anthropic rates. Prior versions overcharged Sonnet prompt cache reads by two times and inflated short Haiku sessions fivefold, causing engineers to observe significantly higher costs than billed.

Terminal typography and visual hierarchy received significant refinements to replace cryptic acronyms with natural language descriptions. The label 7D transitioned to Week, 5H became 5-hour, and countdown timestamps display clear reset timers like resets in 6d 23h. The ribbon also pulls color definitions directly from active Claude Code themes to replace harsh orange bars with native coral accents.

Terminal window clipping bugs that plagued narrow displays have been resolved through adaptive layout restructuring across active sessions. When terminal width shrinks to 64 columns, the status band automatically stacks metrics into multi-row vertical blocks rather than truncating characters offscreen.

03What you gain from A better Claude Code ribbon news update

Developers gain granular visual customization through direct integration with Claude Code plugin settings exposed via the config interface. Users can disable dot bars next to weekly and five-hour windows, leaving clean numeric percentages that dynamically highlight only when quota runs low. The minimal styling preset isolates numerical counters in a consistent sequence covering week, five-hour, context, and cache metrics.

A conditional visibility toggle allows engineers to hide the entire status band during normal typing workflows. The interface remains hidden until quota drops below 25 percent, context occupancy exceeds 85 percent, or the prompt cache turns cold. This automation keeps developer command lines free of unnecessary distraction until urgent usage limits require intervention.

Color theming adjustments ensure that text readability matches native CLI elements across both light and dark backgrounds. Standard metrics adopt default terminal typography, while bold text is restricted strictly to low-quota warnings. A muted color setting shifts all indicators to neutral gray tones, restoring alert colors only when utilization approaches dangerous operational thresholds.

04How to get A better Claude Code ribbon news update

Upgrading to the new usage band requires removing the legacy RoboNuggets package to prevent duplicate interface elements before installing the fork. Developers run plugin management commands directly inside the CLI environment to remove the existing extension and download the Kompas repository cleanly:

claude plugin uninstall ribbon@robonuggets
claude plugin install ribbon --marketplace Kompas/ribbon

To maintain underlying compatibility with modern Anthropic models and tools, developers can verify and update their primary Claude Code CLI installation across global package managers. Executing these official update routines guarantees that the terminal harness supports the latest extension configuration specifications:

claude update
npm install -g @anthropic-ai/claude-code

Engineers can launch specific model configurations, switch active model profiles, or set persistent defaults within their terminal sessions using standard CLI flags and runtime slash commands. These commands allow developers to pin lightweight models or toggle advanced reasoning tiers without exiting their current shell:

claude --model fable
/model fable
/model claude-fable-5-1
claude config set model fable

05What to watch after A better Claude Code ribbon news update

Users must monitor prompt cache expiration settings because the plugin relies on baseline heuristic durations. The ribbon estimates a one-hour cache lifespan for subscription plans and five minutes for direct API key access. If workspace configurations diverge from these defaults, developers must manually specify Cache length in the config menu to prevent warm cache predictions from drifting by up to 55 minutes.

Developers unfamiliar with specific ribbon metrics can run the slash command ribbon in their prompt to print an explanatory legend of all active indicators. This on-demand reference clarifies cache status strings like Cache warm cold in 56m alongside projected cold restart expenses.

The community fork operates independently of the original RoboNuggets repository, which maintained 17 open pull requests including seven competing fixes for display clipping. Users should track upstream developments at Kompas/ribbon for future configuration schema updates as Anthropic introduces new model pricing tiers and CLI extension specifications.