What is OVO_Aus_api AGENTS.md?

Project-specific instructions for maintaining a Home Assistant integration that retrieves OVO Energy Australia usage, billing, and electric-vehicle data. Home Assistant is software for automating and monitoring smart homes.

Running, changing, and releasing the integration while preserving its supported software versions, authentication behavior, sensor data, entity names, and privacy protections.

It explains the project's technical constraints and the risks of changes that could break users' dashboards, energy history, login, or private account data.

How HallyAus/OVO_Aus_api configures Codex and OpenCode

Reuse

Borrowing it

Nothing to install: this file belongs to HallyAus/OVO_Aus_api. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file

curl -O https://raw.githubusercontent.com/HallyAus/OVO_Aus_api/main/AGENTS.md

Clone the repo

git clone --depth 1 https://github.com/HallyAus/OVO_Aus_api

Made for: Codex, OpenCode.

Wrote 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.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/hallyaus/ovo_aus_api/agents-md/github.svg)](https://agentmods.dev/instructions/hallyaus/ovo_aus_api/agents-md)

Your own site

<a href="https://agentmods.dev/instructions/hallyaus/ovo_aus_api/agents-md"><img src="https://agentmods.dev/badge/instructions/hallyaus/ovo_aus_api/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/instructions/hallyaus/ovo_aus_api/agents-md"><img src="https://agentmods.dev/badge/instructions/hallyaus/ovo_aus_api/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 2,503 This file is loaded in full into every session.

When invoked 2,503 The same file — it is already loaded in full.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

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.1	$0.02503	$0.02503
Opus 5.5	$0.01001	$0.01001
Sonnet 5.5	$0.00501	$0.00501
Haiku 4.5	$0.00250	$0.00250

Measured 4d ago against content hash 578489c4db8e, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

OVO_Aus_api 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 4d 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 · 172 lines

How it starts

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

GitHub source control and self-hosted runner (current policy, 2026-10-22)

Canonical repository: https://github.com/HallyAus/OVO_Aus_api. GitHub is the source of truth. Commit, push, open pull requests and publish tags/releases to GitHub; do not publish to former Git servers or maintain a secondary recovery mirror.
Branch and remote: Use the repository's current GitHub default/production branch, verify git remote -v before pushing, preserve uncommitted work and never force-push over newer commits.
CI/CD: A self-hosted GitHub Actions runner is available. Prefer it for eligible jobs when the repository has a configured workflow; use the exact runner labels verified in repository settings or existing workflows. Do not assume the runner's OS, permissions, online status or available secrets, and do not expose credentials to untrusted contributions.
Validation and deployment: Keep the project's existing tests, security checks, branch protections, release approvals, staging/acceptance and production verification. A GitHub push or green build is not proof of production deployment. Do not silently enable or bypass deployment triggers, and never infer that Vercel, Proxmox or another target deploys automatically.
Precedence: This section overrides older hosting, mirror, disabled-Actions and publishing instructions elsewhere in this file. Preserve non-hosting project-specific safety rules.

OVO Energy Australia — agent operating guide

Home Assistant custom integration for OVO Energy Australia. Real users install releases through HACS, so changes must preserve compatibility, privacy and release integrity.

AGENTS.md is the canonical agent instruction file for this repository. CLAUDE.md points here for compatibility. Current release/runtime facts live in STATUS.md; historical incidents and expensive lessons live in LEARNINGS.md.

Mission and risk

A mistake can break Home Assistant dashboards, long-term statistics, authentication or billing/usage displays for real users. The integration also handles a cleartext MyOVO password and account/vehicle PII.

Read the full file on GitHub · 172 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.

4d ago Changed · +10 lines · +189 tokens per session 578489c4db8e
14d ago Changed · +8 lines · +292 tokens per session f9f79f2469db
2mo ago Changed · +31 lines · -234 tokens per session d09afbe4092f
2mo ago Changed · +10 lines · +126 tokens per session 74d2d58012dd
2mo ago First seen · 113 lines · 2,130 tokens per session scan A fab05f78b2cf

Subscribe to this mod's changes

OVO_Aus_api AGENTS.md is an instructions file published in the GitHub repository HallyAus/OVO_Aus_api (28 stars, last pushed yesterday), licensed MIT. It adds 2,503 tokens to every session, about $0.0100 per session on Opus 5.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.

Backend and APIs australia custom-component energy-monitoring hacs home-assistant ovo-energy

OVO_Aus_api AGENTS.md next to 6 instructions from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
OVO_Aus_api AGENTS.mdHallyAus/OVO_Aus_api	Instructions file	28	yesterday	MIT	A	2,503	Codex, OpenCode
vscode buildNext.instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	9,719	GitHub Copilot
next.js AGENTS.mdvercel/next.js	Instructions file	143k	today	MIT	A	7,461	Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchain	Instructions file	149k	yesterday	MIT	A	4,680	Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	5,516	GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscode	Instructions file	195k	yesterday	MIT	A	3,093	GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness	Instructions file	274k	2d ago	MIT	A	4,313	Codex, OpenCode

OVO_Aus_api: Instructions file for Codex