claude-hud

A Claude Code plugin that shows what's happening - context usage, active tools, running agents, and todo progress

22 articles 6.2k View on GitHub ↗
22 articles
How Claude HUD Validates and Applies Element Order in the Expanded Layout

Learn how Claude HUD validates and applies element order in its expanded layout. Discover the `validateElementOrder` and `renderExpanded` functions for safe, deduplicated ordering.

internals
Mar 18, 2026
How Claude HUD Reads CLAUDE.md, Rules, MCPs, and Hook Counts from Configuration

Discover how Claude HUD reads CLAUDE.md, rules, MCPs, and hook counts. Learn about project-local and user-wide configuration scanning in src/config-reader.ts.

how-to-guide
Mar 18, 2026
How Claude HUD Manages Terminal Width Wrapping and Text Truncation in the Render Loop

Discover how Claude HUD manages terminal width, wrapping, and text truncation. Learn its smart approach to visual length and color code preservation.

internals
Mar 18, 2026
How Claude HUD Implements HTTPS_PROXY Support for the Anthropic Usage API

Learn how Claude HUD implements HTTPS_PROXY support using a custom Node.js HTTPS agent to route Anthropic API requests through an HTTP CONNECT tunnel. Get detailed insights from the source code.

internals
Mar 18, 2026
How Custom API Endpoints (`ANTHROPIC_BASE_URL`) Disable Claude HUD’s Usage Display

Learn how custom API endpoints like ANTHROPIC_BASE_URL disable Claude HUD's usage display by bypassing OAuth data fetching, removing the usage percentage from your terminal.

how-to-guide
Mar 18, 2026
How Claude HUD Resolves OAuth Credentials: Prioritizing macOS Keychain Over Legacy Files

Discover how Claude HUD resolves OAuth credentials, securely prioritizing macOS Keychain over legacy files for robust authentication. Learn more.

deep-dive
Mar 18, 2026
How Claude HUD Handles Config Migration for Legacy Upgrades

Learn how Claude HUD automatically migrates legacy config formats by converting obsolete layout properties to the current HudConfig schema during initialization.

migration-guide
Mar 18, 2026
How Claude HUD Resolves and Parses the Transcript Path on Every Render Cycle

Learn how Claude HUD resolves and parses the transcript path on every render cycle. Discover its efficient line by line streaming to keep your display updated with the latest session activity.

internals
Mar 18, 2026
How Claude HUD Extracts Path Levels (1-3 Directories) from the Current Working Directory

Discover how Claude HUD extracts 1-3 directory levels from your current working directory. Learn about its path splitting and slicing techniques for efficient path management.

how-to-guide
Mar 18, 2026
How Color Overrides Are Validated and Applied in Claude HUD: A Complete Guide

Learn how Claude HUD validates and applies color overrides using a whitelist and the resolveAnsi helper. Discover fallbacks for invalid entries in this comprehensive guide.

deep-dive
Mar 18, 2026
Usage API Caching TTL in Claude HUD: Success vs Failure Handling

Understand Claude HUD's usage API caching TTL. Learn how 5-minute success and 15-second failure caches balance rate limits with data freshness for optimal performance.

internals
Mar 18, 2026
Claude HUD Context Value Display Modes: Percent, Tokens, and Remaining Explained

Understand Claude HUD context display modes percent, tokens, and remaining. Learn how each mode calculates usage in your settings.json file for better Claude token management.

deep-dive
Mar 18, 2026

Have a question about this repo?

These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:

Share the following with your agent to get started:
curl -s "https://instagit.com/install.md"
Works with
Claude Codex Cursor VS Code OpenClaw Any MCP Client

Maintain an open-source project? Get it listed too →