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.
npx agentmods add instructions/flz/iaqualink-py/claude-mdgit clone --depth 1 https://github.com/flz/iaqualink-pyWrote 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.
[](https://agentmods.dev/instructions/flz/iaqualink-py/claude-md)<a href="https://agentmods.dev/instructions/flz/iaqualink-py/claude-md"><img src="https://agentmods.dev/badge/instructions/flz/iaqualink-py/claude-md.svg" alt="Measured on agentmods" height="20"></a>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.01114 | $0.01114 |
| Opus 5 | $0.00557 | $0.00557 |
| Sonnet 5 | $0.00223 | $0.00223 |
| Haiku 4.5 | $0.00111 | $0.00111 |
Grade A, and why
iaqualink-py 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 6d 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.
How it starts
The opening of the file, as written. The whole thing — 95 lines — stays where its author put it; the contents beside it link to each section on GitHub.
CLAUDE.md
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
Confidentiality
Repo-tracked files must contain only wire-observable identifiers: hostnames, URLs, HTTP header names, JSON field names, numeric constants, protocol constants visible on the wire.
ALLOWED: hostnames, URLs, HTTP header names, JSON wire field names, numeric constants, protocol constants observable at the wire level.
NOT ALLOWED: Java/Kotlin file paths, package names (com.zodiac.*, com.amazonaws.*), class names, method names, variable names from any external reference source.
The private tooling that researches protocol behavior and produces architecture docs lives outside this repo.
Project Overview
Async Python library for Jandy iAqualink pool control systems. Three system types:
- iAqua — iaqualink.net API
- eXO — zodiac-io.com API (AWS IoT shadow)
- i2d — iQPump variable-speed pumps, r-api.iaqualink.net control API
Development Commands
See docs/contributing/setup.md for setup, testing, linting, and docs commands.
Worktree setup: bash scripts/setup-worktree.sh (idempotent; installs prek hooks, checks PATH).
Architecture
See docs/contributing/architecture.md for class hierarchy, auth patterns, session management, and data flow.
Key patterns:
AqualinkSystemuses__init_subclass__+NAMEsubclass registry;from_data()dispatches bydevice_typerefresh()is a template method — concrete systems implement_refresh(), must setself.statusbefore returning- Session persistence via
AqualinkAuthState; CLI uses cookie jar with atomic writes - Tests: plain pytest classes with per-test helpers,
respxfor HTTP mocking,asyncio_mode = "auto"
API Reference
See docs/reference/ for per-system wire-level protocol specs (source of truth for endpoints, fields, enums).
Adding Support for New System Types
See docs/contributing/new-system-type.md for the full step-by-step guide and checklist. Key rules: _refresh() must set self.status before returning on every path and must not catch AqualinkServiceException subclasses; register the new module in src/iaqualink/client.py; update all docs listed in the guide in the same PR.
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.
- 6d ago First seen · 95 lines · 1,114 tokens per session scan A d741291dfacd
iaqualink-py CLAUDE.md is an instructions file published in the GitHub repository flz/iaqualink-py (45 stars, last pushed 5d ago), licensed BSD-3-Clause. It adds 1,114 tokens to every session, about $0.0056 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-30.
Other instructions, from other repositories
pypylon AGENTS.md
Instructions for basler/pypylon, covering agents.md, repository map, environment, common commands and or, to (re)build in place after changing bindings.
robots AGENTS.md
AGENTS.md instructions for strands-labs/robots, covering agents.md - strands-labs/robots, project dashboard, repository structure, development and install with all optional deps.
uiprotect AGENTS.md
AGENTS.md instructions for uilibs/uiprotect, covering notes for llm contributors, what this project is, code style, commit / pr conventions and running tests.
pymobiledevice3 CLAUDE.md
Claude Code instructions for doronz88/pymobiledevice3, a project described as: Pure python3 implementation for working with iDevices (iPhone, etc...).
kvm-pilot CLAUDE.md
Instructions for DustinTrap/kvm-pilot, covering claude.md, what this is, non-negotiable conventions, engineering principles (how to make changes) and layout.
CarolinaCodeConferenceBadge2026 AGENTS.md
Instructions for circuitboardmedics/CarolinaCodeConferenceBadge2026, covering agents.md — circuitpython drive guidance, what this directory is, execution model, hardware — esp32-s3-wroom-1-n8 and display — hs180s10b (st7735s, 160×128, 1.77 inch).