EarlyTerms

hermes.md

Validating · Emerged · 52 days old · Last reviewed

hermes.md is the project-specific configuration file used by Hermes Agent (NousResearch), the 126k-star AI coding agent. Stored at the git root as `HERMES.md` or `.hermes.md`, it holds the agent's system prompt context and takes highest priority over `AGENTS.md` or `CLAUDE.md` when Hermes assembles its prompt.

The filename became a named incident on April 25, 2026, when it was discovered that the case-sensitive string `HERMES.md` appearing in any git commit message caused Claude Code to silently reroute API calls to pay-as-you-go "extra usage" billing — bypassing a user's Max plan quota and generating a $200 overcharge. Anthropic initially refused a refund before reversing under public pressure.

A shipping label with the wrong carrier code — your package still moves, but you get billed full freight instead of your contract rate.

Search Interest

peak 0
updated 2026-06-12
0 0 0
2026-05-14 2026-05-29 2026-06-12
Term Lifecycle
  1. Nascent
    0–7 days
  2. Emergent
    8–30 days
  3. Validating ← now
    31–90 days
  4. Rising
    91–180 days
  5. Established
    180 days +

Why is it emerging now?

TL;DR

On April 25, 2026, a developer found that `HERMES.md` in any git commit message caused Claude Code to silently charge pay-as-you-go rates instead of their Max plan — draining $200 while 86% of quota sat unused. The thread hit 1,194 points on HN, exposing Anthropic's harness-detection as a content-filter false-positive on bare substring matching.

6 forces driving coverage — scroll →
anthropics/claude-code
HERMES.md in commit messages causes requests to route to extra usage billing
Apr 29, 2026 1,194 points · 508 comments (HN)
anthropics/claude-code
HERMES.md triggers 400 'out of extra usage' on Max OAuth
Exact trigger: case-sensitive `HERMES.md` in git log output. `hermes.md`, `HERMES.txt`, and `AGENTS.md` all pass cleanly.
Apr 25, 2026
Theo (t3.gg) @t3dotgg
It is genuinely insane that Anthropic will bill you differently if you mention certain words in your prompt
Apr 2026
ThePrimeagen @ThePrimeagen
Just another day of being convinced that Anthropic has no clue what the hell is going on in their codebase and today is HERMES.md
Apr 2026
TechCrunch
Anthropic says Claude Code subscribers will need to pay extra for OpenClaw support
Boris Cherny: 'subscriptions weren't built for the usage patterns of these third-party tools' — the policy that created the detection logic behind the false-positive.
Apr 4, 2026
Consumer Rights Wiki
Anthropic Claude Code HERMES.md billing flaw
Anthropic initially refused refund; reversed after public pressure, offering full credit plus $200 in service credits.
Apr 28, 2026

Outlook

6-month signal projection and commercial timeline.

Signal medium
Revenue weak

Incident-driven coinage; stays prominent while Anthropic's harness billing controversy persists through Q2 2026.

Risk · Anthropic patches the trigger and the term collapses to a footnote in a changelog.

Analogs · left-pad · log4shell · AGENTS.md

Monetization timeline
  1. now
    Incident SEO window

    Early content ranks on zero-competition SERP while the incident is still news.

  2. 3-6mo
    Comparison / explainer traffic

    Long-tail: 'HERMES.md vs AGENTS.md', 'how to avoid Claude billing bugs'.

  3. 6-12mo
    Historical reference only

    Term settles as a footnote in Anthropic billing policy history unless new variants surface.

Competition & Opportunity for term “hermes.md”

Three heuristic signals derived from the tracked queries, the term's monetization cards, and its cluster neighbors. Directional, not audited.

Content Gap
8 queries tracked
Led by General (8)
8 Suggest-only tails — long-tail opening
Revenue Potential
0% commercial-intent queries
2 monetization angles mapped
Mostly informational — pre-commercial
Build Difficulty
Medium
Stage: validating — incumbents warming up
1 / 10 default TLDs taken · oldest incumbent hermesmd.com (2014-01-14)
9 related terms already published
Heuristic · signals: tracked queries, term monetization cards, cluster neighbors

Ideas for term “hermes.md”

Buildable pitches — turn this term into an article, site, product, post, newsletter, video, or course. Steal any card and run with it.

Article
HERMES.md vs AGENTS.md vs CLAUDE.md: Which Config File Does What in 2026

Evergreen comparison piece capturing developers confused about AI agent config file conventions. Low competition now, durable once the incident fades.

Article
How Anthropic Detects Third-Party Harnesses in Claude Code — and What Triggers False Positives

Technical explainer targeting developers debugging unexpected billing. The HERMES.md case is the canonical example of content-filter billing misclassification.

Article
Claude Code Billing: What Counts as Extra Usage and How to Avoid Surprise Charges

Practical guide covering the April 4 harness policy, HERMES.md false-positive, and safe commit message conventions.

Product
A Claude Code billing auditor CLI — scan your git history for known billing-trigger strings before running agents

Niche but high-value tool for Max plan users with large codebases. Could ship as an npm package; charge via one-time purchase or freemium.

Post
I Lost $200 to a Filename. Here's the Claude Billing Bug Nobody Warned Me About.

First-person incident narrative for LinkedIn / Substack. The absurdity of a case-sensitive markdown filename silently draining credits is inherently shareable.

Post HN / r/programming
The Anthropic Billing Black Box: How a Commit Message Filename Triggered $200 in Phantom Charges

A developer bisected 12 commits to discover that `HERMES.md` — but not `hermes.md` — silently rerouted Claude Code requests to pay-as-you-go billing.

Post Newsletter / LinkedIn
The Year AI Billing Got Weaponized by Your Own Commit History

Anthropic's April 4 harness-killing policy was controversial. What nobody expected was that the detection logic would flag developers who merely named a file after a mythology figure.

Post YouTube / Tech media
Anthropic's Billing Bug That Cost Developers $200 — Explained in 5 Minutes

One filename. Case-sensitive. In a git commit from months ago. $200 gone. Here's how Anthropic's harness-detection false-positive actually works under the hood.

What People Search

Long-tail queries from Google Suggest + Trends. Volume and competition are heuristics — directional, not audited. Content Type comes from query shape.

Keyword
Competition
Content Type
hermes.com
Low
General
hermes md
Very Low
General
hermes mdt
Very Low
General
hermes mdm
Very Low
General
hermes mdw 2025
Very Low
General
hermes mdd
Very Low
General
hermes md india
Very Low
General
hermes mdm removal
Very Low
General
Updated 2026-06-12 · sources: Google Trends, Google Suggest · Competition is heuristic

SERP of term “hermes.md”

What searchers see today — organic results on top, paid ads if anyone's bidding. Ad density is a real-time commercial signal.

FAQ

What is hermes.md?

hermes.md is the project-specific configuration file used by Hermes Agent (NousResearch), the 126k-star AI coding agent.

Why is hermes.md emerging now?

On April 25, 2026, a developer found that `HERMES.md` in any git commit message caused Claude Code to silently charge pay-as-you-go rates instead of their Max plan — draining $200 while 86% of quota sat unused. The thread hit 1,194 points on HN, exposing Anthropic's harness-detection as a content-filter false-positive on bare substring matching.

When did hermes.md emerge?

Publicly emerged around 2026-04-25 (about 52 days ago as of 2026-06-16). EarlyTerms first recorded a pipeline signal on 2026-04-30.

Related Terms

Other terms in the same space — aliases, subtypes, competitors, and neighbors to explore next.

Explore next
Also mentioned
  • Also known as Hermes Agent config

Sources

Primary URLs this report cites — open any to verify the claim yourself.

  1. 01 GitHub Issue #53262 — HERMES.md in commit messages causes requests to route to extra usage billing github.com ↗
  2. 02 GitHub Issue #53171 — HERMES.md triggers 400 'out of extra usage' on Max OAuth (content filter false-positive) github.com ↗
  3. 03 TechCrunch — Anthropic says Claude Code subscribers will need to pay extra for OpenClaw support techcrunch.com ↗
  4. 04 Consumer Rights Wiki — Anthropic Claude Code HERMES.md billing flaw consumerrights.wiki ↗
  5. 05 Hermes Agent prompt assembly docs — HERMES.md as top-priority context file hermes-agent.nousresearch.com ↗
  6. 06 NousResearch/hermes-agent — GitHub (126k stars) github.com ↗
  7. 07 Theo (t3.gg) on X — billing differently for certain words in prompt x.com ↗
  8. 08 ThePrimeagen on X — Anthropic has no clue what's going on in their codebase x.com ↗