CLAUDE.md examples from real projects

How real projects brief Claude Code: the commands, conventions and warnings they put in CLAUDE.md.

Best matches · from page 23Worked for most · soon

initializCLAUDE.md

forge

initializ/forge/CLAUDE.md

bearer (omitting it → 401 "missing org-id header"). Pattern lives in `admission_loader.go` / `remote_session_store.go` / `mcp/platform_token.go`. - **MCP auth types** (`auth.type`): `oauth`/`bearer`/`static` + managed `platform` (agent-principal token from `ForgeConfig.Platform.token_endpoint

2223mo agoDiscuss

Maneek21CLAUDE.md

Deft

Maneek21/Deft/CLAUDE.md

TypeScript, REST endpoints, WebSocket via Socket.io) ├── packages/ │ ├── db/ # Drizzle ORM schema + client + migrations │ ├── mcp/ # MCP server SDK + tool definitions for BYOA agents │ └── shared/ # Shared types, Zod schemas, constants ├── docker-compose.yml # Self

2214mo agoReads credentialsDiscuss

netboxlabsCLAUDE.md

netbox-mcp-server

netboxlabs/netbox-mcp-server/CLAUDE.md

NetBox MCP Server ## Core Concept A read-only [Model Context Protocol](https://modelcontextprotocol.io/) server that enables LLMs to interact with NetBox infrastructure data. Built with FastMCP and designed

22112mo agoDiscuss

nirholasCLAUDE.md

three.ws

nirholas/three.ws/CLAUDE.md

through the real `/register` page and writes both vars back; no server-side code reads them, so the Cloud Run env does not need them. Unauthenticated sweep: `npm run audit

21711d agoReads credentialsDiscuss

RLabs-IncCLAUDE.md

gemini-mcp

RLabs-Inc/gemini-mcp/CLAUDE.md

Gemini MCP Server Project Guide This document provides essential information for Claude when working with this Gemini MCP server project. ## Project Overview This project is an MCP (Model Context Protocol

2178mo agoReads credentialsDiscuss

KonghaYaoCLAUDE.md

peri / peri-acp

KonghaYao/peri/peri-acp/CLAUDE.md

resume` / `fork`）里的 `mcpServers` acp 型声明在响应写入后由 `host/requests/acp_mcp.rs` 受理（`attach_session_servers`）；`mcp/connect` 只带 client 声明的 `serverId`，因此受理顺序不能提前到响应之前。会话级服务持有连接（每个会话一个 MCP 池），入站 `mcp/message` 按 `connectionId` 定位承载会话、未知连接返回 `-32001`，内层 MCP

21648d agoDiscuss

KonghaYaoCLAUDE.md

peri / peri-middlewares

KonghaYao/peri/peri-middlewares/CLAUDE.md

close_session`（幂等，`mcp/disconnect` 有上界）（ARC-MCP-ACP-001）。 - **System MCP 启动准入**：`system_mcp = true` 的 server 必须在首个 Reason 前完成 transport / initialize / 能力协商 / 真实 `tools/list`（空数组是成功结果，`Err` 不是发现证据），由启动闸门 hook

21648d agoDiscuss

AppGramCLAUDE.md

agentnotch

AppGram/agentnotch/CLAUDE.md

watching │ ├── Settings/ │ │ └── AppSettings.swift # @AppStorage settings │ ├── Telemetry/ │ │ ├── TelemetryCoordinator.swift # OTLP telemetry handling │ │ └── OTLPHTTPServer.swift # HTTP server for telemetry │ └── Process/ │ └── MCPProcessManager.swift # MCP process management ├── Models/ │ ├── ClaudeCodeModels.swift # ClaudeSession, ClaudeToolExecution, etc. │ └── CodexModels.swift # CodexSession, CodexToolExecution, etc. ├── Views

2159mo agoDiscuss

ItamarZand88CLAUDE.md

CLI-Anything-WEB

ItamarZand88/CLI-Anything-WEB/CLAUDE.md

generated CLIs 3. **FALLBACK**: `mcp__chrome-devtools__*` — only if playwright unavailable 4. **NEVER**: `mcp__claude-in-chrome__*` — cannot capture request bodies ## Generated CLI Structure Every generated CLI follows this exact

21546d agoDiscuss

RoasbeefCLAUDE.md

obsidian-claude-code

Roasbeef/obsidian-claude-code/CLAUDE.md

Features built-in tools, skill loading, and custom Obsidian-specific tools via SDK MCP server. ## Development Commands ```bash # Install dependencies (use bun, not npm) bun install # Development mode with watch

2159mo agoReads credentialsDiscuss

team-telnyxCLAUDE.md

ai

team-telnyx/ai/.claude/CLAUDE.md

hosted models) - `tools/python/` — Python agent toolkit (PyPI) - `tools/typescript/` — TypeScript agent toolkit (npm) - `tools/mcp/` — MCP proxy server - `tools/ffl-cli/` — Filling-from-life CLI - `cli/` — agent CLI for provisioning Telnyx infrastructure - `inference/` — Telnyx

2145mo agoReads credentialsDiscuss

alexei-ledCLAUDE.md

k8s-mcp-server

alexei-led/k8s-mcp-server/CLAUDE.md

MCP Server — Development Guide ## Build & Test Commands ```bash make install # Install dependencies make dev-install # Install with dev deps make test # Unit tests only (default) make test-all # All tests

2137mo agoDiscuss

claudioemmanuelCLAUDE.md

squeez

claudioemmanuel/squeez/CLAUDE.md

2126mo agoDiscuss

samberCLAUDE.md

cc-skills

samber/cc-skills/CLAUDE.md

Claude Code, not a portable guarantee. **Qualify every MCP tool with its server.** An MCP entry in `allowed-tools` carries its server name — `mcp__context7__resolve-library

21243d agoDiscuss

zendev-shCLAUDE.md

goai

zendev-sh/goai/CLAUDE.md

files │ ├── gemini/ # Schema sanitization (Vertex, Google) │ ├── sse/ # SSE parser │ └── httpc/ # HTTP helpers + ParseDataURL ├── mcp/ # MCP (Model Context Protocol) client ├── observability/ │ ├── langfuse/ # Langfuse observability integration (separate go.mod) │ └── otel/ # OpenTelemetry tracing

2126mo agoDiscuss

FerroxLabsCLAUDE.md

ijfw

FerroxLabs/ijfw/CLAUDE.md

aider/` -- Aider rules-only tier (`~/.aider.conf.yml` + `~/CONVENTIONS.md`) - `universal/` -- 20-line paste-anywhere rules file - `mcp-server/` -- Cross-platform MCP memory server (Node.js, zero deps) - `scripts/e2e-smoke.sh` -- end-to-end test harness

2105mo agoDiscuss

tarunlnmiitCLAUDE.md

autopilot-jobhunt

tarunlnmiit/autopilot-jobhunt/CLAUDE.md

export jobs from the past 7 days python -m job_hunt.mcp_server # start the MCP server (Claude Code / Claude Desktop) ``` ## Config files | File | Controls | Gitignored? | |---|---|---| | `config.json` | Candidate profile, LLM settings, Telegram

2083mo agoReads credentialsDiscuss

aouicherCLAUDE.md

graphmind

aouicher/graphmind/CLAUDE.md

graphmind Local-first code intelligence CLI with MCP server. ## Tech Stack - **Rust** — full Cargo workspace - **Parsing**: tree-sitter via napi-rs (`crates/graphmind-core/`) - **Graph**: SQLite + FTS5 (`crates/graphmind-db/`) - **Memory**: JSONL store + cross

2074mo agoPipes a download into a shellDiscuss

dmarcguardhqCLAUDE.md

parse-dmarc

dmarcguardhq/parse-dmarc/CLAUDE.md

logger/ # Structured logging setup │ │ └── logger.go # Zerolog configuration │ ├── mcp/ # MCP (Model Context Protocol) server │ │ ├── server.go # MCP server (stdio and HTTP/SSE) │ │ ├── tools.go # MCP tool implementations │ │ └── oauth/ # OAuth2 authentication for MCP │ │ ├── config.go # OAuth

20710d agoDiscuss

xiaojiou176-openCLAUDE.md

codeflow

xiaojiou176-open/codeflow/CLAUDE.md

aligned in the same patch; current examples include `docs/agent-starters/index.html`, `examples/coding-agents/README.md`, the shared read-only MCP example under `examples/coding-agents/mcp/`, and the local plugin-bundle manifests under `examples/coding-agents/plugin-bundles/` that stay starter-only

2074mo agoReads credentialsDiscuss

CLAUDE.md vs AGENTS.md

About CLAUDE.md

What is CLAUDE.md?

A file Claude Code reads at the start of every session. It holds the commands, conventions and warnings the agent needs for this project.

Where does it go?

At the repository root. Claude Code also reads CLAUDE.md files in subdirectories when it works there.

What should it contain?

Build and test commands, the project's layout, conventions that aren't obvious from the code, and mistakes to avoid. Short files tend to work better than long ones.

CLAUDE.md or AGENTS.md?

Claude Code reads CLAUDE.md; most other agents read AGENTS.md. Many projects keep one and point the other at it.