What is esprec AGENTS.md?

A set of instructions for coding agents using esprec, a tool that captures a device’s screen over a USB serial connection and saves it as an image or animation. It explains which project files and commands to consult first.

Taking device screenshots, creating comparison images, and checking a device’s display against a mockup or expected reference.

It prevents agents from guessing how device screenshots should be captured or confusing screen capture with product deployment and identity commands.

esprec AGENTS.md — Instructions file by tig

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/tig/esprec/agents-md

Clone the repo

git clone --depth 1 https://github.com/tig/esprec

Made for: Codex, OpenCode.

Per session 5,384 This file is loaded in full into every session.

When invoked 5,384 The same file — it is already loaded in full.

Security scan A 0 findings. Scan, not verified.

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	$0.05384	$0.05384
Opus 5	$0.02692	$0.02692
Sonnet 5	$0.01077	$0.01077
Haiku 4.5	$0.00538	$0.00538

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

Security

Grade A, and why

esprec AGENTS.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.

AGENTS.md · 466 lines

How it starts

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

AGENTS.md — how to use esprec

Canonical playbook for AI coding agents (Claude Code, Grok Build, Copilot, Codex, and kin) when the human says use tig/esprec or pastes a README Getting Started prompt.

Human overview: README.md. Product requirements: specs/spec.md. CI ladder: specs/ci.md. Short CLI dump: esprec agent-guide.

esprec is eyes, not hands. Capture device pixels over USB serial → host PNG/GIF. Product serial commands (btn, identity, deploy) stay in the product / Silico path. Do not invent a private capture stack when this tool covers the wire.

0. Load path (do this first)

Priority	Open	When
1	This file (`AGENTS.md`)	Any “use esprec” / screenshot / golden / mockup-vs-device task
2	`esprec agent-guide`	Need flag surface only
3	specs/spec.md / specs/ci.md	Changing protocol, component, or CI shape
—	Product GCU `AGENTS.md` / Silico first-ship	Deploy, identity, board COM — not capture wire format

If you only skimmed the README examples, you have not followed this playbook.

1. Mission in one line

device UI → full-frame shadow → USB serial (ESPREC1 + base64) → host PNG and/or GIF

On-device: component/esprec emits frames; does not encode PNG/GIF.
Host: this package’s CLI/library receives frames and post-processes images.
Integrity: ESPREC1 CRC covers metadata + raster. Truncation, wrong length, or header tamper fail closed — never silent “valid” junk images.

2. Install (host)

Python ≥ 3.11. Prefer a sibling clone next to the product GCU:

# layout: .../tig/esprec  and  .../tig/<gcu>
python -m pip install -e "../esprec[dev]"   # from GCU repo
# or from this checkout:
python -m pip install -e ".[dev]"
esprec agent-guide
esprec snapshot --fake -o face.png          # offline smoke (no board)

From git without a sibling tree:

Read the full file on GitHub · 466 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 First seen · 466 lines · 5,384 tokens per session scan A 7c1548b212f6

Subscribe to this mod's changes

esprec AGENTS.md is an instructions file published in the GitHub repository tig/esprec (5 stars, last pushed 1mo ago), licensed Apache-2.0. It adds 5,384 tokens to every session, about $0.0269 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-31.

Hardware and IoT

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

esprec AGENTS.md

Getting it into your agent

What it costs to keep this loaded

Grade A, and why

Nothing flagged

How it starts

AGENTS.md — how to use esprec

0. Load path (do this first)

1. Mission in one line

2. Install (host)

What this file has done since we first saw it

Other instructions, from other repositories

FastLED GEMINI.md

kicad-happy GEMINI.md

brilliant_sdk AGENTS.md

NeoMind CLAUDE.md

AMD-BC-250-Windows-Driver AGENTS.md

Nothan-OS CLAUDE.md