AGENTS.md@herdr git:20261104.59bb2d6A

Immutable. This exact content never changes and is served at /api/v1/blob/f118779e42fdc1d8.

# figlens for Herdr

- `figlens/` is the mod folder shared at herdr.dev/mods: keep it to `mods/figlens/`,
  `RECIPE.md` and `preview.png`. `figlens-layout/` is the "Herdr + figlens" layout:
  `layouts/herdr-figlens.json` with its settings picture, an identical copy of
  `mods/figlens/`, `RECIPE.md` and `preview.png`. Change the mod in
  `figlens/mods/figlens/` and copy it over; a test checks the copies match.
  Tests and docs stay outside both folders.
- Follow Herdr's installed `~/.config/herdr-app/AGENTS.md`, `herdr.d.ts` and
  `gpui-kit.d.ts`. Mods are plain JavaScript in QuickJS: no Node APIs,
  `setTimeout` or `Intl`; never keep a `cx` past its callback; never notify
  during render.
- Keep `engine.js` and `frames.js` free of Herdr imports so
  `node --test herdr/tests/*.test.mjs` runs them. `VERSION` in `engine.js` is
  bumped by Release Please through a `generic` extra-files entry that rewrites
  its marked line; never edit it by hand.
- Use Herdr theme tokens only; secondary text is `muted`, never `dim`. Every
  change that pastes into an agent or deletes files asks first.
- Network: only the engine download from GitHub Releases. Programs: `figlens`,
  `hc`, `sh` with its standard tools (`stat`, `find`, `dd`, `tar`, `realpath`,
  `sha256sum`/`shasum`, `awk`), `curl` for the download, the platform file
  picker and `open`/`xdg-open`. Keep README, RECIPEs and
  code in step on hosts, programs, storage and behavior.
- Each `preview.png` is a screenshot of the real mod or layout running in
  Herdr, in English, on a public or synthetic design; never a private design.
- Check every change with `herdr-app check herdr/figlens/mods/figlens` and look
  at it running; load the `herdr` topic for the details.