ranges.py: the sensor column is as wide as the longest name, the numeric columns one character wider: a 10-character name or a value like -1.137e-13 no longer runs into the next column (contents unchanged) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
tools
The reading harness: the methods given to the agent to make sense of the data of an AIMsight station. Each tool answers a question the analyst asks and returns values, dated ranges, a figure or thumbnails; it shows, it does not judge.
scripts/: the tools, one script each;GUIDE.md: which tool for which question, and how to read what it returns. The agent reads it first.DATA.md: the files of a station and the meaning of their columns, maintained by hand; the agent reads it with the guide.scripts/data.py: the one reader of the data, shared by the aimsight-app app, the tools and the detectors (which import it); a change to it changes the detectors' benchmark (python3 detectors/bench/regression.py --labels labeling/auto --data data, from aimsight-app).scripts/common.py: the helpers the tools share.- The tools:
inventory,summary,ranges,days,overview,metrics,quality,stations,plot,thumbnails,gif(details in the guide).
Using it
The calling repository points to it through a link tools -> ~/aimsight-tools (ignored by git), next to its data/ and labeling/ links, and runs the tools from its root:
python3 tools/scripts/inventory.py data/NORDEND --start 2026-11-05T00:00Z --end 2026-11-06T00:00Z
.venv/bin/python tools/scripts/plot.py data/NORDEND --start 2026-11-05T00:00Z --end 2026-11-06T00:00Z --out out/diagnostic
Without --out, the figures go to out/diagnostic/ of the current folder. Standard library; matplotlib (through the caller's .venv) for the figures only.
Who changes it
Only the upgrader (agents repository) writes there, run by Optimizer's optimize skill after an analysis: it brings the analyst's useful scripts into the tools; it adds, changes or removes (a tool only for a good reason, CLAUDE.md).
Copied from aimsight-app (agent-tools/ and the lire-les-donnees skill, commit dd6f1bf) on 2026-11-16. The architecture of the repositories: ~/aimsight-app/docs/architecture.drawio.