frugal-iot: Instructions file for Claude Code

CLAUDE.md

frugal-iot CLAUDE.md is an instructions file for Claude Code from mitra42/frugal-iot. It costs 41,166 tokens per session, scanned A, original, MIT.

Repository-specific instructions for the Frugal-IoT library, which runs sensor networks on affordable ESP32 and ESP8266 microcontrollers. They cover Arduino IDE and PlatformIO compatibility, examples, and generated build settings.

In plain words
What is it for?
Use them when changing the library, testing Arduino examples, configuring board partitions, or preparing a release.
Why use it?
They help keep examples working across both supported development environments and prevent manual edits to files that are generated from build settings.

Instructions file for Claude Code

Written for Claude Code: the file is CLAUDE.md.

This is mitra42/frugal-iot's own configuration. It tells Claude Code how to work on frugal-iot itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything frugal-iot configures →

Reuse

Borrowing it

Nothing to install: this file belongs to mitra42/frugal-iot. 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/mitra42/frugal-iot/main/CLAUDE.md
Clone the repo
git clone --depth 1 https://github.com/mitra42/frugal-iot

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.

agentmods badge for frugal-iot CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/mitra42/frugal-iot/claude-md/github.svg)](https://agentmods.dev/instructions/mitra42/frugal-iot/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/mitra42/frugal-iot/claude-md"><img src="https://agentmods.dev/badge/instructions/mitra42/frugal-iot/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.

agentmods 80×15 button for frugal-iot CLAUDE.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/mitra42/frugal-iot/claude-md"><img src="https://agentmods.dev/badge/instructions/mitra42/frugal-iot/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 41,166 This file is loaded in full into every session.
When invoked 41,166 The same file — it is already loaded in full.
Security scan A 0 findings. 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.

ModelPer sessionOnce invoked
Fable 5.1 $0.41166 $0.41166
Opus 5.5 $0.16466 $0.16466
Sonnet 5.5 $0.08233 $0.08233
Haiku 4.5 $0.04117 $0.04117

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

Security

Grade A, and why

frugal-iot 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 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.

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 · 2,456 lines

How it starts

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

Frugal-IoT Library

A platform for affordable, easily built sensor networks running on ESP32/ESP8266 microcontrollers. Library version: 2.0.0. MIT licence. Author: Mitra Ardron.

Wiki: https://github.com/mitra42/frugal-iot/wiki Repo: https://github.com/mitra42/frugal-iot

Compatibility

Every example .ino file must work in both:

  • Arduino IDE — open the .ino directly; dependencies installed via Library Manager
  • PlatformIO — referenced via lib_deps = Frugal-IoT@^2.0.0 in platformio.ini

Each example directory contains a platform.h file alongside the .ino. This file is auto-generated from the example's platformio.ini by running scripts/prerelease.bash (which calls scripts/generate_platform_h.py). It converts -D FLAG=value build flags into #define statements and wraps board-specific defines in #ifdef ARDUINO_BOARD_NAME guards.

  • PlatformIO reads flags directly from platformio.ini; platform.h is not used.
  • Arduino IDE picks platform.h up because _settings.h includes it when PLATFORMIO is undefined — the .ino does not need to (and on ESP8266 could not; see below).

Do not hand-edit platform.h or esp8266/<sketch>.ino.globals.h. Do not regenerate them during development either — don't run scripts/prerelease.bash or generate_platform_h.py after changing platformio.ini. They are rebuilt at release time; regenerating them in between only clutters the repo with diffs. Leave them stale.

arduino_compile.bash (below) regenerates platform.h as a side effect. If you use it, restore the generated files afterwards (git checkout -- 'examples/*/platform.h' 'examples/*/esp8266/') so they don't end up in a commit.

Diagnosing someone else's setup: scripts/frugal_iot_doctor.py

A single standard-library Python file (3.6+) meant to be sent to a user and run in their project or sketch folder; it only reads, and prints OK/INFO/WARN/FAIL lines with a fix under each. It runs the PlatformIO checks when there is a platformio.ini, the Arduino IDE checks when there is a .ino or neither, and both in an example folder, which has both. Each check is a failure seen in beta testing - src_dir = . with a clone in lib/ (every symbol defined twice), a lib_deps spec that lib/'s copy does not satisfy, a dependency that failed to install once and is never retried, two copies of the library in the sketchbook, #define in build_opt.h. It also checks the uncommitted settings files - platformio-secrets-local.ini, platformio-local.ini, platform-secrets-local.h - for being missing, misnamed (.ini.txt), still holding the template's placeholder, or setting one key in both *-local.ini files. It reports whether the enrolment secret is set and never prints it, since the output is pasted into chats; keep it that way.

Read the full file on GitHub · 2,456 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. 2d ago Changed · +33 lines · +654 tokens per session e5fecd0ae039
  2. 5d ago Changed · +82 lines · +1,760 tokens per session f331422191d2
  3. 7d ago Changed · +11 lines · +254 tokens per session 75d5fdf439b9
  4. 10d ago Changed · +3 lines · +146 tokens per session 3c04ecb74f9d
  5. 13d ago Changed · +137 lines · +2,635 tokens per session 55f3c1a77779
  6. 26d ago Changed · +21 lines · +419 tokens per session 612b1503b62e
  7. 28d ago Changed · +38 lines · +799 tokens per session af25afe5834d
  8. 1mo ago Changed · +46 lines · +995 tokens per session 1b5258208738
  9. 1mo ago Changed · +55 lines · +1,179 tokens per session 443e3b4d5f9e
  10. 1mo ago First seen · 2,030 lines · 32,325 tokens per session scan A f7a1ce4db3f3

Subscribe to this mod's changes

frugal-iot CLAUDE.md is an instructions file published in the GitHub repository mitra42/frugal-iot (11 stars, last pushed 3d ago), licensed MIT. It adds 41,166 tokens to every session, about $0.1647 per session on Opus 5.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.

Related

frugal-iot CLAUDE.md compared with instructions from other repositories

frugal-iot CLAUDE.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
frugal-iot CLAUDE.mdmitra42/frugal-iotInstructions file113d agoMITA41,166Claude Code
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA9,719GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file143kyesterdayMITA7,461Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA5,685GitHub Copilot
langchain AGENTS.mdlangchain-ai/langchainInstructions file149ktodayMITA4,680Codex, OpenCode
vscode copilot-instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA3,086GitHub Copilot
vscode model-prompts.instructions.mdmicrosoft/vscodeInstructions file195ktodayMITA2,022GitHub Copilot