omamail AGENTS.md

omamail AGENTS.md is an instructions file for Codex, OpenCode from huacnlee/omamail. It costs 9,999 tokens per session, scanned A, original, MIT.

Repository guidance for Omamail, a desktop application built with QML and JavaScript, covering its visual theme, layout, module organization, libraries, and entry points. It requires colors to come from the active system theme rather than fixed values.

In plain words
What is it for?
Adding or editing views and components, passing theme colors through the application, organizing modules, and following the project's JavaScript and QML conventions.
Why use it?
It helps agents make interface changes that match the application's theme and keep related code together.

Instructions file for CodexOpenCode

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/huacnlee/omamail/agents-md
Clone the repo
git clone --depth 1 https://github.com/huacnlee/omamail

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.

agentmods badge for omamail AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/huacnlee/omamail/agents-md.svg)](https://agentmods.dev/instructions/huacnlee/omamail/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/huacnlee/omamail/agents-md"><img src="https://agentmods.dev/badge/instructions/huacnlee/omamail/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 9,999 This file is loaded in full into every session.
When invoked 9,999 The same file — it is already loaded in full.
Security scan A 1 finding. 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.

ModelPer sessionOnce invoked
Fable 5 $0.09999 $0.09999
Opus 5 $0.04999 $0.04999
Sonnet 5 $0.02000 $0.02000
Haiku 4.5 $0.01000 $0.01000

Measured today against content hash bec3f686790e, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

omamail AGENTS.md scanned grade A with 1 finding 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 today.

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.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

- The transport is `scripts/mail-transport.sh`, which is curl. Fields cross to
AGENTS.md · 570 lines

How it starts

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

Repository working agreements

Colors

  • Use colors from the active Omarchy system theme. Do not hard-code UI colors.
  • Pass semantic colors down from App.qml as required component properties so a theme change propagates through every view.
  • Derive muted, hover, and selected variants from an inherited color with alpha, or from Style.normalFillFor / hoverFillFor / selectedFillFor. Do not introduce literal fallback grays.
  • Secondary text mixes the foreground toward the background, not Qt.darker. On a light theme, darkening an almost-black foreground makes "secondary" text heavier than body text — the opposite of what it means.
  • tests/test_source.sh enforces the no-literal-colors rule. Keep it updated rather than working around it.

Layout

Grouped by module, not by file type. A module holds whatever doing its job takes — the rules in .js, the object in .qml, side by side. There is no directory of "all the JavaScript": that arrangement puts a provider's parsing three directories away from the client that calls it.

Module What it is
root Service.qml, BarWidget.qml, App.qml, and nothing else. manifest.json names these three and the shell loads them at that path.
providers/ Everything that differs between mail services: a description per provider, the registry over them, the protocol each speaks, and the pair of objects — signs in, fetches — that each needs.
account/ One mailbox and the list of them. MailAccount.qml, Accounts.js, and the rules in Model.js about what a list does after an action.
cache/ What a query result and a message body are kept in, and the two objects that keep them.
calendar/ The calendars an account serves and their events: the sources in Sources.js, the rules in Calendar.js, the controller that reads and writes them, and the range cache.
message/ A message's own content: parsing it (Message.js) and making it safe to draw (Html.js).
components/ Views. They draw what they are given and decide nothing.

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

  1. today Changed · +76 lines · +1,805 tokens per session bec3f686790e
  2. 5d ago First seen · 494 lines · 8,194 tokens per session scan A 24772281a34f

Subscribe to this mod's changes

omamail AGENTS.md is an instructions file published in the GitHub repository huacnlee/omamail (149 stars, last pushed today), licensed MIT. It adds 9,999 tokens to every session, about $0.0500 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.