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.
npx agentmods add instructions/ycanerden/mesh/agents-mdgit clone --depth 1 https://github.com/ycanerden/meshWhat 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 | $0.00578 | $0.00578 |
| Opus 5 | $0.00289 | $0.00289 |
| Sonnet 5 | $0.00116 | $0.00116 |
| Haiku 4.5 | $0.00058 | $0.00058 |
Grade C, and why
mesh AGENTS.md scanned grade C 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 3d 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.
Downloads and executes remote codehighSupply chain
curl | sh runs whatever the server returns today, which is not necessarily what it returned when this was reviewed.
`curl -fsSL https://bun.sh/install | bash -s bun-v1.3.11` Makes network callslowCapability
Not a fault in itself. Listed so you know the mod talks to something, and to what.
`curl -fsSL https://bun.sh/install | bash -s bun-v1.3.11` How it starts
The opening of the file, as written. The whole thing — 55 lines — stays where its author put it; the contents beside it link to each section on GitHub.
AGENTS.md
Cursor Cloud specific instructions
Mesh is a single-process Bun + Hono app with embedded SQLite. There is no separate database, frontend dev server, or worker process.
Prerequisites
- Bun 1.3.11 (matches
Dockerfile). Ifbunis missing, install with:curl -fsSL https://bun.sh/install | bash -s bun-v1.3.11 - Ensure
$HOME/.bun/bin(or/usr/local/bin/bun) is onPATH.
Commands
| Task | Command |
|---|---|
| Install deps | bun install |
| Dev server | bun run dev → http://localhost:3000 |
| Run (no hot reload) | bun run start |
| Tests | bun test src/*.test.ts |
| Lint | (none configured) |
Services
Only one service must run for end-to-end development: the Mesh server (bun run dev). SQLite is created automatically as mesh.db in the repo root (or under MESH_DATA_DIR when set).
Optional: cd cli && bun run dev for the mesh-rooms CLI — not required for dashboard/API work.
Environment variables
Copy .env.example to .env if needed. Defaults work for local dev on port 3000. See .env.example for ADMIN_ROOM_PASSWORD, DEFAULT_ROOMS, etc.
Hello-world check
curl http://localhost:3000/health
curl -X POST "http://localhost:3000/api/send?room=test&name=AgentA" \
-H "Content-Type: application/json" -d '{"message":"hello"}'
curl "http://localhost:3000/api/messages?room=test&name=AgentB"
Open http://localhost:3000/dashboard?room=test for the web UI.
Dashboard tapbacks (+1 / yes / love)
- Reactions use
POST /api/reactwith the viewer name from the composer field (not the defaultyou). - Claimed agent names require the token stored at
localStorage['mesh-token:ROOM:NAME'](set via/api/enter/ invite flow). The dashboard sends it asx-agent-token. - Failed reactions must not flip the SSE connection badge; use
apiAction()indashboard.html, notapi().
Gotchas
- Do not run
railway upor deploy — only Lisan al-Gaib deploys to Railway perCLAUDE.md. - No compile/build step; Bun runs TypeScript directly.
- Playwright is in devDependencies but no npm script uses it yet.
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.
- 3d ago First seen · 55 lines · 578 tokens per session scan C 290f9be30bc9
mesh AGENTS.md is an instructions file published in the GitHub repository ycanerden/mesh (5 stars, last pushed 17d ago), licensed MIT. It adds 578 tokens to every session, about $0.0029 per session on Opus 5. A static security scan graded it C with 2 findings (downloads and executes remote code, makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other instructions, from other repositories
tokscale AGENTS.md
AGENTS.md instructions for junhoyeo/tokscale, covering ai agent guidelines, maintaining agents.md files, authoring pr/issue content via gh cli, git identity & merge discipline and commit message convention.
codedb AGENTS.md
AGENTS.md instructions for justrach/codedb, covering codedb agent guidelines, what codedb is (and isn't), review guidelines, pre-merge verification and security-sensitive areas.
codedb copilot-instructions.md
Copilot instructions for justrach/codedb, covering codedb — agent instructions, project, rules, filing issues and test style.
codedb CLAUDE.md
Claude Code instructions for justrach/codedb, covering codedb — agent instructions, project, rules, filing issues and test style.
cli CLAUDE.md
Instructions for archgate/cli, covering claude.md, technology stack, commands, validation gate and git hooks (git 2.54+).
smriti CLAUDE.md
Instructions for zero8dotdev/smriti, covering smriti, memory, start of every session, recognize these moments — then act immediately and how to save a decision.