CLAUDE.mdA

CLAUDE.md from lucassimzq/claude-usage-mod is a CLAUDE.md file: the standing instructions Claude Code reads in that repo.

Install it, pinned
mdr add lucassimzq/claude-usage-mod/CLAUDE.md@git:20261018.48042cf

Pins git:20261018.48042cf in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
CLAUDE.md file
Repository
lucassimzq/claude-usage-mod
Path
CLAUDE.md
Versions recorded
13
Latest version
git:20261018.48042cf, committed Oct 18, 2026
First version recorded
Oct 5, 2026
Size
13,271 bytes
Repository stars
5
License
MIT

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# claude-usage-mod

A Claude Code mod (a plugin of function hooks, plugin name `usage-hud`) that draws the context window, the 5-hour session limit and the weekly limit as a band above the prompt, beside a pixel Clawd whose mood follows the highest of the three.

## Layout

- `.claude-plugin/plugin.json`: the manifest; `types` points at the state contract.
- `hooks/hooks.json`: lists the one hooks module.
- `hooks/register.tsx`: the whole mod.
- `types/index.d.ts`: the contract for the values the mod keeps in `$.state` (`gauges`, `isHidden`, `activity`, `jumps`, `game`) and the saved `Progress`.
- `tests/*.test.ts`: `claude plugin test .` runs them.
- `scripts/render-docs.ts`: renders `docs/banner.svg` and `docs/states/*.svg` for the README.
- `website/`: the showcase page. `website/site/` is static and draws with the mod's own code (`hud.js`, generated from a release commit by `node website/build/hud.mjs`); `website/test/` holds its Playwright checks. See `website/README.md`.
- `.claude-plugin/types/`: type files the engine writes for editors; ignored by its own `.gitignore`.

## How it works
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add lucassimzq/claude-usage-mod/CLAUDE.md@sha256:e300831986cccefa

The line at the top of this page pins the label git:20261018.48042cf, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_x3kga2u6n7qopdk3.svg)](https://markdownregistry.com/a/art_x3kga2u6n7qopdk3)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 13 versions of this file, between Oct 5, 2026 and Oct 18, 2026, about one every day.

versioncommittedcommitsizeaudit
git:20261018.48042cf latest2026-10-18 48042cf 13,271 BA view · diff
git:20261018.1dc22152026-10-18 1dc2215 13,051 BA view · diff
git:20261018.db5d7a92026-10-18 db5d7a9 12,294 BA view · diff
git:20261007.8cc067d2026-10-07 8cc067d 11,787 BA view · diff
git:20261006.f9eac9b2026-10-06 f9eac9b 11,547 BA view · diff
git:20261006.f2f0a9b2026-10-06 f2f0a9b 11,184 BA view · diff
git:20261006.f8a1d1e2026-10-06 f8a1d1e 10,746 BA view · diff
git:20261006.6a0ad7e2026-10-06 6a0ad7e 10,110 BA view · diff
git:20261005.c6da3e12026-10-05 c6da3e1 8,935 BA view · diff
git:20261005.cee4c762026-10-05 cee4c76 8,767 BA view · diff
git:20261005.9809cf52026-10-05 9809cf5 8,344 BA view · diff
git:20261005.8512fde2026-10-05 8512fde 8,132 BA view · diff
git:20261005.8195bff2026-10-05 8195bff 8,009 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (13271 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

lucassimzq/claude-usage-mod · 5 stars · license MIT · pushed 2026-10-18 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_x3kga2u6n7qopdk3
GET https://markdownregistry.com/api/v1/resolve?ref=lucassimzq/claude-usage-mod/CLAUDE.md
GET https://markdownregistry.com/api/v1/blob/e300831986cccefaac1d36692de4636ee82b3a1bc2454b402d973663a2e7c06e

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: what a CLAUDE.md file is · keeping AGENTS.md and CLAUDE.md in sync · which agent file does what.

Other files named CLAUDE.md

CLAUDE.md CLAUDE.md file
affaan-m/ecc · CLAUDE.md
git:20261020.9471ef4 · audit A · 299,696 stars
CLAUDE.md CLAUDE.md file
firecrawl/firecrawl · CLAUDE.md
git:20261008.5a75dca · audit A · 199,595 stars
CLAUDE.md CLAUDE.md file
garrytan/gstack · CLAUDE.md
git:20261107.ef99eb5 · audit A · 140,694 stars
CLAUDE.md CLAUDE.md file
juliusbrussee/caveman · CLAUDE.md
git:20261106.af560e1 · audit B · 118,366 stars
CLAUDE.md CLAUDE.md file
addyosmani/agent-skills · CLAUDE.md
git:20260720.8fd2081 · audit A · 113,383 stars
CLAUDE.md CLAUDE.md file
nexu-io/open-design · CLAUDE.md
git:20260430.9b57c22 · audit B · 106,541 stars
CLAUDE.md CLAUDE.md file
pbakaus/impeccable · CLAUDE.md
git:20261105.71dfd50 · audit A · 106,186 stars
CLAUDE.md CLAUDE.md file
debpalash/voicestudio · CLAUDE.md
git:20261104.c2998f6 · audit A · 102,675 stars

Browse by kind, by grade A, or by owner.