agentmods.dev

claude-code-plugin-hud CLAUDE.md

claude-code-plugin-hud CLAUDE.md is an instructions file for coding agents from sj817/claude-code-plugin-hud. It costs 1,165 tokens per session, scanned A, original, MIT.

A Claude Code plugin with a Rust command-line program that displays session information in Claude Code’s status line. A status line is the small information row shown in the terminal while working.

In plain words
What is it for?
Use it to install the status-line command, render session data from Claude Code input, and display it across terminal sizes and supported status changes.
Why use it?
It makes session details visible in the terminal and handles the sizing, terminal events, and setup needed for the display to fit correctly.

Instructions file

not rated 3 6d ago A scan 1,165 tokens original MIT
View the source file sj817/claude-code-plugin-hud
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/sj817/claude-code-plugin-hud/claude-md
Clone the repo
git clone --depth 1 https://github.com/sj817/claude-code-plugin-hud

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for claude-code-plugin-hud CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/sj817/claude-code-plugin-hud/claude-md.svg)](https://agentmods.dev/instructions/sj817/claude-code-plugin-hud/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/sj817/claude-code-plugin-hud/claude-md"><img src="https://agentmods.dev/badge/instructions/sj817/claude-code-plugin-hud/claude-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 1,165 This file is loaded in full into every session.
When invoked 1,165 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.01165 $0.01165
Opus 5 $0.00583 $0.00583
Sonnet 5 $0.00233 $0.00233
Haiku 4.5 $0.00117 $0.00117

Measured 4d ago against content hash 95501c7f2157, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

claude-code-plugin-hud CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 88 lines

How it starts

The opening of the file, as written. The whole thing — 88 lines — stays where its author put it; the contents beside it link to each section on GitHub.

claude-code-plugin-hud — project notes

A Rust CLI that renders the Claude Code statusline, shipped as a Claude Code plugin.

  • Package name: claude-code-plugin-hud
  • Binary name: claude-hud (kept short)
  • Prebuilt per-platform binaries ship in dist/.
  • The namespaced /claude-code-plugin-hud:setup command wires a binary into the user's settings.json. Plugins cannot set the main statusLine themselves; only a command can.

How the statusline contract works

  • Claude Code streams session JSON to the binary on stdin. Whatever the binary prints to stdout is shown, one rendered row per printed line.
  • It runs after each assistant message, after /compact, and on permission/vim changes (debounced 300ms). It does not re-run while you type.
  • Terminal size comes from the COLUMNS/LINES env vars (v2.1.153+), not tput. COLUMNS is the whole terminal: Claude Code then insets the statusline by statusLine.padding columns per side, so the drawable width is narrower than COLUMNS.
  • Width math must count emoji as terminals paint them. unicode-width follows East_Asian_Width, which calls ⏱ (U+23F1) one cell; char_cells in render.rs overrides that range to 2.
  • Many JSON fields are optional or null (see src/input.rs). Never unwrap.
  • Newer fields are also version-gated: prompt_cache and rate_limits.spend_limit need v2.1.251+, pr.kind needs v2.1.234+. Model them as Option and keep a fallback, so older builds still render fully.
  • Permission mode (auto/plan/…) is not in the statusline JSON, so the HUD does not show it. Hooks expose permission_mode, but no hook fires on a bare shift+tab toggle, so it cannot be shown reliably. Omitted intentionally.

Architecture

File Responsibility
src/main.rs Read stdin, parse, read $COLUMNS/$LINES, subtract the statusline padding, print.
src/input.rs Serde structs; every field optional/defaulted.
src/render.rs Layout rules: constant height, width-aware drop by priority, single bar, smart path. Start here for display changes.
src/git.rs Branch + dirty flag, cached per session_id (5s TTL).
src/theme.rs Calm 16-color palette, three accents (pink cache, soft-gold folder, orange quota band), and the usage / four-band quota threshold colors.

Read the full file on GitHub · 88 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 88 lines · 1,165 tokens per session scan A 95501c7f2157

Subscribe to this mod's changes

claude-code-plugin-hud CLAUDE.md is an instructions file published in the GitHub repository sj817/claude-code-plugin-hud (3 stars, last pushed 6d ago), licensed MIT. It adds 1,165 tokens to every session, about $0.0058 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

claudeclaude-codeclaude-code-hudclaude-code-pluginhud
Related

Other instructions, from other repositories

cc-hud CLAUDE.md

Instructions for WaterTian/cc-hud, covering claude.md — cc-hud 项目指令, 项目概述, 技术栈, 项目结构 and 数据流.

WaterTian/cc-hud · 835 tokens

cc-zhipu-hud CLAUDE.md

Instructions for beiyuii/cc-zhipu-hud, covering cc-zhipu-hud, tech stack, commands, project structure and data flow.

beiyuii/cc-zhipu-hud · 1,083 tokens

cc-zhipu-hud AGENTS.md

Instructions for beiyuii/cc-zhipu-hud, covering cc-zhipu-hud, tech stack, commands, project structure and key design decisions.

beiyuii/cc-zhipu-hud · 533 tokens

claude-hud-enhanced CLAUDE.md

Instructions for johnleeGitHub/claude-hud-enhanced, covering claude.md, project overview, build commands, test (node.js test runner — requires build first) and test (bun — runs source .ts directly, no build needed).

johnleeGitHub/claude-hud-enhanced · 1,967 tokens

river-review GEMINI.md

Gemini CLI instructions for s977043/river-review, covering gemini instructions (river-review), 必須チェック, gemini-specific tips, prompt assembly and development tips.

s977043/river-review · 318 tokens

living-manual CLAUDE.md

Instructions for dougstanford/living-manual, covering living-manual, start of every session, how work lands — non-negotiable, user's manual (living-manual) and releasing.

dougstanford/living-manual · 1,108 tokens