What is claude-dashboard CLAUDE.md?

Development instructions for Claude Dashboard, a Claude Code plugin that shows status, context usage, API limits, and cost information in a configurable status line. It covers the project structure, technologies, hooks, commands, and widgets.

Use them when changing dashboard widgets, the status-line script, usage checks, setup commands, hooks, or plugin packaging.

They show how the plugin’s status display and setup process fit together, reducing the risk of breaking version compatibility or configuration migration.

How uppinote20/claude-dashboard configures Claude Code

Reuse

Borrowing it

Nothing to install: this file belongs to uppinote20/claude-dashboard. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/uppinote20/claude-dashboard/main/CLAUDE.md

Clone the repo

git clone --depth 1 https://github.com/uppinote20/claude-dashboard

Made for: Claude Code.

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.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/uppinote20/claude-dashboard/claude-md/github.svg)](https://agentmods.dev/instructions/uppinote20/claude-dashboard/claude-md)

Your own site

<a href="https://agentmods.dev/instructions/uppinote20/claude-dashboard/claude-md"><img src="https://agentmods.dev/badge/instructions/uppinote20/claude-dashboard/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/instructions/uppinote20/claude-dashboard/claude-md"><img src="https://agentmods.dev/badge/instructions/uppinote20/claude-dashboard/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 6,008 This file is loaded in full into every session.

When invoked 6,008 The same file — it is already loaded in full.

Security scan C 1 finding. A grade says what 26 rules found in the file — not that it is safe.

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.

Model	Per session	Once invoked
Fable 5.1	$0.06008	$0.06008
Opus 5.5	$0.02403	$0.02403
Sonnet 5.5	$0.01202	$0.01202
Haiku 4.5	$0.00601	$0.00601

Measured 2d ago against content hash 3bcd396a0cfd, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade C, and why

claude-dashboard CLAUDE.md scanned grade C with 1 finding 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 2d 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.

Recursive force deletehighDestructive command

rm -rf with a variable or a broad path is one typo away from removing the wrong tree.

3. Test with expired cache (`rm -rf ~/.cache/claude-dashboard/`)

CLAUDE.md · 421 lines

How it starts

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

Claude Code Configuration

Project Overview

claude-dashboard is a Claude Code plugin that provides a comprehensive status line with modular widget system, multi-line display, context usage, API rate limits, and cost tracking.

Tech Stack

Runtime: Node.js 18+
Language: TypeScript 5.0+
Build: esbuild
Target: Claude Code Plugin

Project Structure

claude-dashboard/
├── .claude-plugin/
│   ├── plugin.json          # Plugin manifest
│   └── marketplace.json     # Marketplace metadata
├── commands/
│   ├── setup.md             # /claude-dashboard:setup command
│   └── check-usage.md       # /claude-dashboard:check-usage command
├── hooks/
│   ├── hooks.json           # SessionStart hook registration
│   └── ensure-statusline.mjs # Shim sync + settings migration
├── scripts/
│   ├── statusline-shim.mjs  # Version-agnostic entry point (copied to PLUGIN_DATA)
│   ├── statusline.ts        # Main entry point (status line)
│   ├── check-usage.ts       # CLI usage dashboard entry point
│   ├── mod/
│   │   ├── register.tsx     # Mod entry: /claude-dashboard-pane pane + /claude-dashboard-band band
│   │   ├── stdin-builder.ts # Builds renderer stdin from mod API state
│   │   ├── ansi.ts          # ANSI parser for mod rendering
│   │   ├── node-path.ts     # Locate node when the host PATH lacks it (nvm/fnm/volta)
│   │   └── toggle.ts        # on/off/toggle + pane view argument rules
│   ├── views/               # Pane session views (/claude-dashboard-pane <view>)
│   │   ├── index.ts         # View registry
│   │   ├── overview.ts      # dashboard tab overview (sections; used when modPane is unset)
│   │   ├── shared.ts        # Shared view helpers
│   │   ├── turns.ts         # turns view (per-prompt tokens/tools)
│   │   ├── agents.ts        # agents view (subagent status)
│   │   ├── files.ts         # files view (edited files)
│   │   ├── todos.ts         # todos view
│   │   ├── errors.ts        # errors view (failed tool calls)
│   │   └── background.ts    # bg view (background jobs)
│   ├── types.ts             # TypeScript interfaces
│   ├── widgets/             # Widget system
│   │   ├── base.ts          # Widget interface
│   │   ├── index.ts         # Widget registry & orchestrator
│   │   ├── model.ts         # Model widget
│   │   ├── context.ts       # Context usage widget
│   │   ├── cost.ts          # Cost widget
│   │   ├── rate-limit.ts    # Rate limit widgets (5h, 7d)
│   │   ├── project-info.ts  # Project info widget
│   │   ├── config-counts.ts # Config counts widget
│   │   ├── session-duration.ts # Session duration widget
│   │   ├── tool-activity.ts # Tool activity widget
│   │   ├── agent-status.ts  # Agent status widget
│   │   ├── todo-progress.ts # Todo progress widget
│   │   ├── burn-rate.ts     # Burn rate widget
│   │   ├── cache-hit.ts     # Cache hit rate widget
│   │   ├── prompt-cache.ts  # Prompt cache health widget + state/hit/misses sub-widgets (stdin.prompt_cache)
│   │   ├── depletion-time.ts # Depletion time widget
│   │   ├── codex-usage.ts   # Codex CLI usage widget
│   │   ├── gemini-usage.ts  # Gemini CLI usage widget
│   │   ├── antigravity-usage.ts # Antigravity CLI usage widget
│   │   ├── zai-usage.ts     # z.ai/ZHIPU usage widget
│   │   ├── usage-format.ts  # Shared percent + reset countdown formatter
│   │   ├── token-breakdown.ts # Token breakdown widget
│   │   ├── performance.ts   # Performance badge widget
│   │   ├── forecast.ts      # Cost forecast widget
│   │   ├── budget.ts        # Budget tracking widget
│   │   ├── token-speed.ts   # Token speed widgets (session + last response)
│   │   ├── session-name.ts  # Session name widget
│   │   ├── today-cost.ts    # Today cost widget
│   │   ├── last-prompt.ts   # Last prompt widget
│   │   └── peak-hours.ts   # Peak hours widget
│   └── utils/
│       ├── api-client.ts    # OAuth API client with caching
│       ├── codex-client.ts  # Codex CLI API client
│       ├── gemini-client.ts # Gemini CLI API client
│       ├── antigravity-client.ts # Antigravity CLI API client
│       ├── zai-api-client.ts # z.ai/ZHIPU API client
│       ├── provider.ts      # Provider detection (anthropic/zai/zhipu)
│       ├── colors.ts        # ANSI color codes + theme system
│       ├── credentials.ts   # Keychain/credentials extraction (60s backoff on failure)
│       ├── debug.ts         # Debug utilities
│       ├── formatters.ts    # Token/cost/time/duration formatting
│       ├── hash.ts          # Token hashing for cache keys
│       ├── i18n.ts          # Internationalization
│       ├── progress-bar.ts  # Progress bar rendering
│       ├── session.ts       # Session duration tracking
│       ├── budget.ts        # Budget tracking utilities
│       ├── subagents.ts     # Subagent transcript scan (agent-*.jsonl + .meta.json)
│       ├── band-marker.ts   # Per-session band heartbeat marker (band-<sessionId>)
│       ├── render-mode.ts   # Mod pane/band render mode detection
│       └── transcript-parser.ts # Transcript JSONL parsing
├── types/
│   └── mod-state.d.ts       # Mod state type declarations
├── locales/
│   ├── en.json              # English translations
│   └── ko.json              # Korean translations
├── dist/
│   ├── index.js             # Status line built output (committed)
│   ├── check-usage.js       # CLI usage dashboard built output (committed)
│   └── mod.js               # Mod (/claude-dashboard-pane, /claude-dashboard-band) built output (committed)
└── package.json

Read the full file on GitHub · 421 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.

2d ago Changed · +14 lines · +344 tokens per session 3bcd396a0cfd
3d ago Changed · +37 tokens per session 32f5bf050607
1mo ago Changed · +1 lines · +29 tokens per session 7d23d2f7d6b4
1mo ago Changed · +20 lines · +406 tokens per session ea6edb5b0c85
1mo ago Changed · +1 lines · +119 tokens per session fb0e048ea1c3
1mo ago Changed · +7 lines · +411 tokens per session c0adae3243e7
2mo ago First seen · 378 lines · 4,662 tokens per session scan C fb23dac5de6b

Subscribe to this mod's changes

claude-dashboard CLAUDE.md is an instructions file published in the GitHub repository uppinote20/claude-dashboard (585 stars, last pushed 3d ago), licensed MIT. It adds 6,008 tokens to every session, about $0.0240 per session on Opus 5.5. A static security scan graded it C with 1 finding (recursive force delete). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

claude-dashboard CLAUDE.md next to 6 instructions from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
claude-dashboard CLAUDE.mduppinote20/claude-dashboard	Instructions file	585	3d ago	MIT	C	6,008	Claude Code
vscode buildNext.instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	9,719	GitHub Copilot
next.js AGENTS.mdvercel/next.js	Instructions file	143k	today	MIT	A	7,461	Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchain	Instructions file	149k	yesterday	MIT	A	4,680	Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	5,516	GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	3,093	GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness	Instructions file	274k	2d ago	MIT	A	4,313	Codex, OpenCode

claude-dashboard: Instructions file for Claude Code