Borrowing it
Nothing to install: this file belongs to heardlabs/heard. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/heardlabs/heard/main/AGENTS.mdgit clone --depth 1 https://github.com/heardlabs/heardWrote 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.
[](https://agentmods.dev/instructions/heardlabs/heard/agents-md)<a href="https://agentmods.dev/instructions/heardlabs/heard/agents-md"><img src="https://agentmods.dev/badge/instructions/heardlabs/heard/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.
<a href="https://agentmods.dev/instructions/heardlabs/heard/agents-md"><img src="https://agentmods.dev/badge/instructions/heardlabs/heard/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>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.03488 | $0.03488 |
| Opus 5.5 | $0.01395 | $0.01395 |
| Sonnet 5.5 | $0.00698 | $0.00698 |
| Haiku 4.5 | $0.00349 | $0.00349 |
Grade B, and why
heard AGENTS.md scanned grade B 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 1mo 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.
Reads agent configuration directoriesmediumAgent snooping
.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.
~/.claude/settings.json hook → python -m heard.hook claude-code How it starts
The opening of the file, as written. The whole thing — 166 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Heard — contributor & agent guide
A macOS voice companion that narrates Claude Code / Codex / arbitrary CLI agents. py2app menu-bar bundle + CLI. Apache 2.0. heard.dev · Releases
This file is the guide for contributors and for coding agents opened in
this repo (Claude Code auto-reads it via CLAUDE.md). Keep it current
when the architecture shifts. For setup, the test gate, and the PR flow,
see CONTRIBUTING.md.
Process model
One process — the menu-bar app (Heard.app) — runs the daemon as an
in-process thread. Hooks installed by Claude Code / Codex are spawned as
short-lived python -m heard.hook <agent> subprocesses. They read the
hook payload from stdin, send a JSON message over a Unix-domain socket to
the daemon, and exit.
CC tool call
↓
~/.claude/settings.json hook → python -m heard.hook claude-code
↓ stdin: {"hook_event_name": "PreToolUse", ...}
heard.client.send_event() → Unix socket
↓
Heard.app (daemon thread) — _handle_event routes by kind:
├─ tool_pre / tool_post → fast-path templates (no LLM) → speech queue
├─ prose / finals → harness (the brain) → speech queue
└─ harness punts (None) → no-LLM floor (canned/template) → speech queue
↓
afplay → history.append (after successful play)
The harness brain is the mandatory narration path for prose and finals. There are exactly three lanes:
- Brain (
harness.narrate) — prose + finals. One narration-brain call with access to the persona, the Agent State scoreboard, and Working Memory. - Fast-path templates — tool actions ("Editing auth.py"); never the brain (latency/cost). Cheap, no LLM.
- No-LLM floor (
Daemon._floor_text) — fires only when the brain punts (LLM unreachable: daily cap, outage, no provider). Tools keep their clean template; a final is read as-is if short, else swapped for a bounded lead of the message prefixed with the project. This floor — not any legacy path — is the only fallback. The floor (and the local Kokoro TTS option) is what keeps Heard from going silent, which for an ambient tool reads as "broken."
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.
- 1mo ago First seen · 166 lines · 3,488 tokens per session scan B f5d6c8505099
heard AGENTS.md is an instructions file published in the GitHub repository heardlabs/heard (214 stars, last pushed today), licensed Apache-2.0. It adds 3,488 tokens to every session, about $0.0140 per session on Opus 5.5. A static security scan graded it B with 1 finding (reads agent configuration directories). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other instructions, from other repositories
vscode buildNext.instructions.md
Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).
next.js AGENTS.md
AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.
vscode oss-third-party-notices.instructions.md
Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, cache eligibility and rollout and applying the notice (cutover).
langchain AGENTS.md
AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.
vscode copilot-instructions.md
Copilot instructions for microsoft/vscode, covering vs code copilot instructions, project overview, root folders, core architecture (src/ folder) and built-in extensions (extensions/ folder).
vscode model-prompts.instructions.md
Model-specific prompt authoring and registry guidelines.