agentwire-dev: Instructions file for Claude Code

CLAUDE.md

agentwire-dev CLAUDE.md is an instructions file for Claude Code from dotdevdotdev/agentwire-dev. It costs 5,143 tokens per session, scanned D, original, Apache-2.0.

Project instructions for AgentWire, a voice interface that lets people talk to AI coding agents running in terminal sessions.

In plain words
What is it for?
They help develop and operate the AgentWire portal, rebuild its components, restart development services, and verify repository and safety settings.
Why use it?
They document the rebuild and restart steps needed for code and structural changes to actually reach the running application.

Instructions file for Claude Code

Written for Claude Code: the file is CLAUDE.md. Also seen: reads .claude/ paths; names the AskUserQuestion tool; mentions Claude Code.

This is dotdevdotdev/agentwire-dev's own configuration. It tells Claude Code how to work on agentwire-dev itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything agentwire-dev configures →

Reuse

Borrowing it

Nothing to install: this file belongs to dotdevdotdev/agentwire-dev. 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/dotdevdotdev/agentwire-dev/main/CLAUDE.md
Clone the repo
git clone --depth 1 https://github.com/dotdevdotdev/agentwire-dev

Made for: Claude Code.

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 agentwire-dev CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/dotdevdotdev/agentwire-dev/claude-md/github.svg)](https://agentmods.dev/instructions/dotdevdotdev/agentwire-dev/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/dotdevdotdev/agentwire-dev/claude-md"><img src="https://agentmods.dev/badge/instructions/dotdevdotdev/agentwire-dev/claude-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.

agentmods 80×15 button for agentwire-dev CLAUDE.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/dotdevdotdev/agentwire-dev/claude-md"><img src="https://agentmods.dev/badge/instructions/dotdevdotdev/agentwire-dev/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 5,143 This file is loaded in full into every session.
When invoked 5,143 The same file — it is already loaded in full.
Security scan D 2 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.

ModelPer sessionOnce invoked
Fable 5.1 $0.05143 $0.05143
Opus 5.5 $0.02057 $0.02057
Sonnet 5.5 $0.01029 $0.01029
Haiku 4.5 $0.00514 $0.00514

Measured today against content hash 17974921de88, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade D, and why

agentwire-dev CLAUDE.md scanned grade D with 2 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 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.

Asks for rootmediumPrivilege escalation

A mod that escalates privileges can change anything on the machine, not only the project.

| `.env` | **All API keys/secrets** — the one blessed spot, loaded on every entry point. `chmod 600`. See [`docs/wiki/security/secrets.md`](docs/wiki/security/secrets.md) |

Recursive force deletehighDestructive command

rm -rf with a variable or a broad path is one typo away from removing the wrong tree.

- **Damage-control hooks** block dangerous ops (`rm -rf`, `git push --force`, etc.)
CLAUDE.md · 196 lines

How it starts

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

AgentWire

Voice interface for AI coding agents. Push-to-talk from any device to tmux sessions running Claude Code.

No Backwards Compatibility - Pre-launch, no customers. Change things completely, no legacy fallbacks.

Always-loaded rules only; design narratives live in docs/wiki/. Before touching a subsystem, read its linked page — the "why" and incident history are there.

Dev Workflow

uv tool install caches builds and ignores source changes.

# Step 0 — after a remote merge, pull first. rebuild reinstalls whatever is
# checked out, so a never-pulled main silently ships stale code.
git pull --ff-only

# During development (picks up changes instantly)
agentwire portal start --dev

# After structural changes (pyproject.toml, new files)
agentwire rebuild

# After code changes: ALWAYS do both
git pull --ff-only && agentwire rebuild && agentwire portal restart --dev

The damage-control engine is not in this repo (#1209 M8). uv sync / uv tool install . / agentwire rebuild resolve damage-control-dev from PyPI at the range in pyproject.toml. To hack on the engine, work in a checkout of github.com/dotdevdotdev/damage-control-dev and point this venv at it (uv pip install -e /path/to/damage-control-dev, then uv run --no-sync … so uv doesn't revert it) — never copy it back into this tree; release it there, then raise the floor here.

Rebuild alone = stale static files. Restart alone = stale Python. The MCP server runs as a separate process started by Claude Code — session restart required after rebuild to pick up MCP changes. rebuild now refuses (warn + --force to override) when the checkout is behind origin/main, and agentwire doctor flags a behind-main checkout, a disabled kill switch (enabled: false in ~/.agentwire/damagecontrol.yml), damage-control rule/hook/matcher drift, and any of ~/.agentwire/ · .env · portal.token · machines.json readable beyond its owner (doctor --yes tightens them; #887).

Tests

Read the full file on GitHub · 196 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 · -39 lines · -7,483 tokens per session 17974921de88
  2. yesterday Changed · +70 tokens per session 183c63219758
  3. 3d ago Changed · +4 lines · +541 tokens per session 9b0911e044b1
  4. 4d ago Changed · +1 lines · +505 tokens per session 6768d4561ba0
  5. 17d ago Changed · +4 lines · +306 tokens per session da0353be5816
  6. 19d ago Changed · +139 tokens per session 958b22cb6fcd
  7. 20d ago Changed · +4 lines · +268 tokens per session c2494fba3c8e
  8. 25d ago Changed · +10 lines · +270 tokens per session 6a57adeb1ca1
  9. 2mo ago First seen · 212 lines · 10,527 tokens per session scan D 6ba0bccff50c

Subscribe to this mod's changes

agentwire-dev CLAUDE.md is an instructions file published in the GitHub repository dotdevdotdev/agentwire-dev (23 stars, last pushed yesterday), licensed Apache-2.0. It adds 5,143 tokens to every session, about $0.0206 per session on Opus 5.5. A static security scan graded it D with 2 findings (asks for root, recursive force delete). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

agentwire-dev CLAUDE.md compared with instructions from other repositories

agentwire-dev CLAUDE.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
agentwire-dev CLAUDE.mddotdevdotdev/agentwire-devInstructions file23yesterdayApache-2.0D5,143Claude Code
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA9,719GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file143ktodayMITA7,461Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchainInstructions file149kyesterdayMITA4,680Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA5,516GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA3,093GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harnessInstructions file274k2d agoMITA4,313Codex, OpenCode