Executive summary

The problem

Teams claim "40% more efficient" or "greener" after a stopwatch test. Energy tools measure watts, profilers measure time, cost tools measure bills, and nothing stops the three being blended into one confident sentence. The result is claims that cannot be reproduced, defended or audited.

What WattSutra AI is

An offline command-line tool plus 20 portable AI-agent skills that make performance claims honest by construction:

What it is not

It is not an energy meter, a carbon accounting product, an SCI-certified calculator or a cloud billing tool. Version 0.2.0 reads no hardware sensor. Energy, carbon and cost remain empty until you import a real meter reading or give explicit model inputs, and then they are labelled as imported or modeled.

Why trust it

ClaimHow you can check it yourself
Tests passnpm test; see observed results (machine-written)
It rejects doctored reportswattsutra audit checks A02, A03, A04
It rejects unfair comparisonsaudit checks A05 to A08
It invents no ratesaudit check A09, A10
No secrets shippedaudit check A15
Zero runtime dependenciesnpm ls --all, package.json

The audit is a self-audit: reproducible evidence, not a third-party certificate. See independent audit for method, results and open limits.

Who benefits

RoleValue
AI / platform engineersA regression gate (compare exits 1 on FAIL) that cannot be fooled by a faster-but-wrong change
FinOpsCost per job with price provenance; absent price stays unknown
Sustainability leadsCarbon only from stated intensity; no invented regional defaults; no false SCI claims
Reviewers and auditorsHash-linked evidence and one command that re-verifies it

Status at a glance

AreaState
CLI and engineShipped, 0.2.0
Reports (JSON, MD, HTML, CSV)Shipped
Self-audit (18 checks)Shipped
20 skills (17 core, 3 advisory)Shipped as role instructions
Hardware sensors (RAPL, NVML, etc.)Roadmap
Arbitrary workload and live inference benchmarksRoadmap, needs sandbox
Signing and attestationRoadmap
Hosted dashboardRoadmap

Decisions needed from a sponsor

None for 0.2.0. For the roadmap: approve a sandbox design before any arbitrary-code benchmark, and approve a trademark search before any marketing use of the name.

Cost and risk

Free, Apache-2.0, no accounts, no network. The main risk is misuse of a number out of context; the tool limits that by labelling and by gates, but cannot stop a human from deleting the caveats.