headroom CLAUDE.md

Project instructions for Headroom, an app that shows local AI coding usage limits and shipping status on devices such as a menu bar, iPhone, Watch, and ESP32 display.

In plain words
What is it for?
Use them when developing, maintaining, or reviewing the Headroom project.
Why use it?
They give a coding agent context about the Headroom project while it works on the code.

Instructions file

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/michellzappa/headroom/claude-md
Clone the repo
git clone --depth 1 https://github.com/michellzappa/headroom
Per session 5 This file is loaded in full into every session.
When invoked 5 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin 100% copy Near-identical to another mod 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.00005 $0.00005
Opus 5 $0.00003 $0.00003
Sonnet 5 $0.00001 $0.00001
Haiku 4.5 $0.00001 $0.00001

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

Security

Grade A, and why

headroom 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 3d 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.

Origin

This is a copy

100% identical to deepseek-harness CLAUDE.md — 3 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

CLAUDE.md · 2 lines

What it actually says

@AGENTS.md

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. 3d ago First seen · 2 lines · 5 tokens per session scan A 336cc4fbf19b

Subscribe to this mod's changes

headroom CLAUDE.md is an instructions file published in the GitHub repository michellzappa/headroom (263 stars, last pushed 7d ago), licensed MIT. It adds 5 tokens to every session, about $0.0000 per session on Opus 5. A static security scan graded it A with 0 findings. It is 100% identical to deepseek-harness CLAUDE.md, differing in 3 lines, and is treated as a copy.

Related

Other instructions, from other repositories

FastLED CLAUDE.md

Claude Code instructions for FastLED/FastLED, covering fastled ai agent guidelines, read the right file for your task, key commands, core rules (all agents) and git and code publishing.

FastLED/FastLED · 2,927 tokens

FastLED GEMINI.md

Gemini CLI instructions for FastLED/FastLED, a project described as: The FastLED library for colored LED animation on Arduino. Please direct questions/requests for help to the FastLED Reddit community: http://fastled.io/r We'd like to use github "issues" just for tracking library bugs / enhancements.

FastLED/FastLED · 9 tokens

ROS AGENTS.md

Instructions for lawliet206/ROS, covering agents.md, 项目是什么, 环境版本(不可随意升级/降级), 目录结构(catkin 工作空间根 = 仓库根) and 重要 launch 与脚本(命名与参数以代码为准,改文档必须同步).

lawliet206/ROS · 1,724 tokens

fridge_tracker AGENTS.md

AGENTS.md instructions for xueyouluo/fridge_tracker, covering 仓库指南, 项目结构与模块组织, 构建、测试与开发命令, 代码风格与命名约定 and 测试规范.

xueyouluo/fridge_tracker · 975 tokens

clawdmeter-plus CLAUDE.md

Claude Code instructions for sorryhumans/clawdmeter-plus, covering project context, hardware (critical pins), amoled-2.16 (original), amoled-1.8 (newer port) and amoled-1.8 (c6) — waveshareamoled18c6.

sorryhumans/clawdmeter-plus · 4,837 tokens

AppClaw CLAUDE.md

Instructions for appclawhq/AppClaw, covering claude.md, what is appclaw?, build & run commands, architecture and entry point & cli modes (src/index.ts).

appclawhq/AppClaw · 2,529 tokens