agentmods.dev

agent-discover CLAUDE.md

agent-discover CLAUDE.md is an instructions file for Claude Code from keshrath/agent-discover. It costs 1,195 tokens per session, scanned A, original, MIT.

Project instructions for agent-discover, a Node.js and TypeScript service that manages connected AI servers, a marketplace, storage, and a web dashboard. It describes the project's architecture, coding style, interface, and versioning.

In plain words
What is it for?
Use it when working on agent-discover's server registry, marketplace, storage, REST or WebSocket interfaces, MCP connections, or dashboard.
Why use it?
It gives an AI coding agent the project-specific rules needed to make consistent changes without guessing how the code is organised.

Instructions file for Claude Code

Written for Claude Code: the file is CLAUDE.md. Also seen: reads .claude/ paths.

not rated 7 4mo ago A scan 1,195 tokens original MIT
View the source file keshrath/agent-discover
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/keshrath/agent-discover/claude-md
Clone the repo
git clone --depth 1 https://github.com/keshrath/agent-discover

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 agent-discover CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/keshrath/agent-discover/claude-md.svg)](https://agentmods.dev/instructions/keshrath/agent-discover/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/keshrath/agent-discover/claude-md"><img src="https://agentmods.dev/badge/instructions/keshrath/agent-discover/claude-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 1,195 This file is loaded in full into every session.
When invoked 1,195 The same file — it is already loaded in full.
Security scan A 0 findings. 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.1 $0.01195 $0.01195
Opus 5 $0.00598 $0.00598
Sonnet 5 $0.00239 $0.00239
Haiku 4.5 $0.00120 $0.00120

Measured 5d ago against content hash a0eedabcf8fe, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

agent-discover CLAUDE.md scanned grade A with 0 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 5d 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.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 82 lines

How it starts

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

agent-discover

Architecture

Layered architecture with explicit dependency injection (no global state):

src/
  domain/     registry (CRUD), proxy (MCP child servers), marketplace (API client),
              installer, secrets, health, metrics, events
  storage/    SQLite (better-sqlite3, WAL mode)
  transport/  REST (node:http), WebSocket (ws), MCP (stdio)
  ui/         Vanilla JS dashboard (no build step for UI)
  • No frameworks -- no React, Vue, Express. Pure Node.js + TypeScript.
  • context.ts is the DI root -- wires all services together.
  • UI files (index.html, app.js, styles.css) are plain files copied to dist/ui/ on build.

UI / Dashboard

  • Icons: Material Symbols Outlined (via Google Fonts CSS). No emojis.
  • Fonts: Inter (UI text), JetBrains Mono (code/data)
  • Theme: Light/dark toggle via [data-theme='dark'] attribute on <html> (light is default in :root)
  • Design tokens: CSS custom properties (--bg, --accent, --border, --shadow-*, etc.)
  • Accent color: #5d8da8
  • Port: 3424 (configurable via AGENT_DISCOVER_PORT)
  • Tabs: 3 tabs — Servers (with Add Server form, merged installed+active), Browse (marketplace), Logs (real-time call log with click-to-expand, filters, clear)
  • Server cards: health dots, error counts (with clear button), expandable Secrets/Metrics/Config sections
  • Theme sync: Supports agent-desk postMessage theme injection + reverse sync

Code Style

  • ESLint + Prettier enforced via lint-staged (husky pre-commit)

Versioning

  • Version lives in package.json and is read at runtime (REST /health, WS state, UI sidebar)
  • Never hardcode version strings
  • Every commit must bump the patch version minimum
  • Commit message format: v1.0.x: short description

Build & Test

npm run build      # tsc + copy UI files to dist/
npm test           # vitest (unit + integration)
npm run check      # typecheck + lint + format + test

Key APIs

  • REST: GET /health, GET /api/servers, GET /api/servers/:id, POST /api/servers, PUT /api/servers/:id, DELETE /api/servers/:id, POST /api/servers/:id/activate, POST /api/servers/:id/deactivate, POST /api/servers/:id/call, POST /api/servers/:id/reset-errors, GET /api/servers/:id/secrets, PUT /api/servers/:id/secrets/:key, DELETE /api/servers/:id/secrets/:key, POST /api/servers/:id/health, GET /api/servers/:id/metrics, GET /api/metrics, GET /api/logs, DELETE /api/logs, GET /api/browse, GET /api/status
  • WebSocket: Full state on connect, delta updates via DB polling, log_entry messages for real-time call logs
  • MCP: 1 action-based tool — registry (actions: list/install/uninstall/activate/deactivate/browse/status) + proxied tools from active servers

Read the full file on GitHub · 82 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. 5d ago First seen · 82 lines · 1,195 tokens per session scan A a0eedabcf8fe

Subscribe to this mod's changes

agent-discover CLAUDE.md is an instructions file published in the GitHub repository keshrath/agent-discover (7 stars, last pushed 4mo ago), licensed MIT. It adds 1,195 tokens to every session, about $0.0060 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

ai-agentsclaude-codemarketplacemcpmcp-servermodel-context-protocol
Related

Other instructions, from other repositories

agentpact-mcp-server AGENTS.md

AGENTS.md instructions for adamkrawczyk/agentpact-mcp-server, covering gitnexus — code intelligence, always do, when debugging, when refactoring and never do.

adamkrawczyk/agentpact-mcp-server · 1,269 tokens

mcp-walmart-marketplace AGENTS.md

AGENTS.md instructions for alyiox/mcp-walmart-marketplace, covering agent instructions, commit messages, header, body and release tags.

alyiox/mcp-walmart-marketplace · 993 tokens

agentpact-mcp-server CLAUDE.md

Claude Code instructions for adamkrawczyk/agentpact-mcp-server, covering gitnexus — code intelligence, always do, when debugging, when refactoring and never do.

adamkrawczyk/agentpact-mcp-server · 1,269 tokens

mcp-walmart-marketplace CLAUDE.md

Claude Code instructions for alyiox/mcp-walmart-marketplace, a project described as: MCP server for Walmart Marketplace APIs (US, 3P seller).

alyiox/mcp-walmart-marketplace · 5 tokens

openrouter-mcp-multimodal AGENTS.md

AGENTS.md instructions for stabgan/openrouter-mcp-multimodal, covering agent instructions, before you ship, releasing (read this before publishing), short version and version files (must all match package.json).

stabgan/openrouter-mcp-multimodal · 793 tokens

Plonk AGENTS.md

AGENTS.md instructions for ostapondo/Plonk, covering agent rules, layout, adding a module, build & verify and code style.

ostapondo/Plonk · 3,557 tokens