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 3Worked for most · soon

CoplayDevCLAUDE.md

unity-mcp

CoplayDev/unity-mcp/CLAUDE.md

Plugin (MCPForUnity/) ↓ Unity Editor API Scene, Assets, Scripts ``` **Two codebases, one system:** - `Server/` - Python MCP server using FastMCP - `MCPForUnity/` - Unity C# Editor package ### Three Layers on the Python Side

15k9mo agoDiscuss

Model Context ProtocolCLAUDE.md

typescript-sdk

modelcontextprotocol/typescript-sdk/CLAUDE.md

High-Level APIs**: - `Client` (`packages/client/src/client/client.ts`) - Client implementation extending Protocol with typed methods for MCP operations - `Server` (`packages/server/src/server/server.ts`) - Server implementation extending Protocol with request handler registration - `McpServer` (`packages/server/src/server/mcp.ts`) - High-level server

13k3mo agoDiscuss

zilliztechCLAUDE.md

claude-context

zilliztech/claude-context/CLAUDE.md

logic lives here; the other packages are thin frontends over it. - `packages/mcp` (`@zilliz/claude-context-mcp`) — stdio MCP server, the primary product. ESM (`"type": "module"`). - `packages/vscode-extension` (`semanticcodesearch`) — VSCode extension. Bundled with webpack; stubs

12k14mo agoReads credentialsDiscuss

mrexodiaCLAUDE.md

ida-pro-mcp

mrexodia/ida-pro-mcp/CLAUDE.md

CLAUDE.md Guidance for working in this repository. ## What this project is IDA Pro MCP Server: exposes IDA Pro / idalib functionality to MCP clients. Main pieces: - `src/ida_pro_mcp/server.py`: MCP server entrypoint - `src/ida_pro_mcp/idalib_server.py

12k2mo agoDiscuss

BeehiveInnovationsCLAUDE.md

pal-mcp-server

BeehiveInnovations/pal-mcp-server/CLAUDE.md

Claude Development Guide for PAL MCP Server This file contains essential commands and workflows for developing and maintaining the PAL MCP Server when working with Claude. Use these instructions

12k13mo agoReads credentialsDiscuss

humanlayerCLAUDE.md

humanlayer

humanlayer/humanlayer/CLAUDE.md

that coordinates approvals and manages Claude Code sessions - `hlyr/` - TypeScript CLI with MCP (Model Context Protocol) server for Claude integration - `humanlayer-wui/` - CodeLayer - Desktop/Web UI (Tauri + React) for graphical approval

11k12mo agoDiscuss

holaboss-aiCLAUDE.md

holaOS

holaboss-ai/holaOS/CLAUDE.md

desktop app (`hola-boss-oss`) + its in-process runtime (`runtime/{harnesses,harness-host,api-server,state-store}`). See `apps/desktop/CLAUDE.md` for desktop-renderer conventions and the parent `~/Developer/CLAUDE.md` for how this

11k2mo agoReads credentialsDiscuss

Hugging FaceCLAUDE.md

chat-ui

huggingface/chat-ui/CLAUDE.md

OpenAI client 5. Streams response back, stores in MongoDB ### Model Context Protocol (MCP) MCP servers are configured via `MCP_SERVERS` env var. When enabled, tools are exposed as OpenAI function

11k50d agoReads credentialsDiscuss

AnthropicCLAUDE.md

claude-for-legal

anthropics/claude-for-legal/CLAUDE.md

commercial-legal, privacy-legal, ...) .claude-plugin/plugin.json # plugin manifest (name, version, description, author) .mcp.json # MCP servers the plugin connects to CLAUDE.md # practice-profile TEMPLATE (see "Plugin CLAUDE.md" below) README.md

9.5k5mo agoDiscuss

AnthropicCLAUDE.md

claude-code-action

anthropics/claude-code-action/CLAUDE.md

imports don't need `.js` extensions. - GitHub API calls should use retry logic (`src/utils/retry.ts`). - MCP servers are auto-installed at runtime to `~/.claude/mcp/github-{type}-server

9.2k8mo agoDiscuss

UpsonicCLAUDE.md

Upsonic

Upsonic/Upsonic/CLAUDE.md

Built-in support for Model Context Protocol tools - can integrate with hundreds of existing MCP servers from the ecosystem. ### Safety Engine Policy-based content filtering and safety enforcement with configurable

7.9k13mo agoReads credentialsDiscuss

Model Context ProtocolCLAUDE.md

registry

modelcontextprotocol/registry/CLAUDE.md

humans (probably most things!), put the instructions in README.md instead._ Import @README.md ## Important: Publishing MCP servers The `data/seed.json` file is seed data for local development only. Do NOT create pull

7.3k51d agoDiscuss

kyegomezCLAUDE.md

swarms

kyegomez/swarms/CLAUDE.md

7.2k2y agoReads credentialsDiscuss

enricorosCLAUDE.md

big-AGI

enricoros/big-AGI/CLAUDE.md

resolves to bare `t.procedure` (the cloud layer lives on `dev`) #### Security Considerations - Server-side keys come from env vars only; client-held keys are user-supplied #### Writing Style - **Never

7.1k9d agoReads credentialsDiscuss

grabCLAUDE.md

cursor-talk-to-figma-mcp

grab/cursor-talk-to-figma-mcp/CLAUDE.md

Cursor AI IDE with Figma. Three components communicate in a pipeline: ``` Cursor AI ←(stdio)→ MCP Server ←(WebSocket)→ WebSocket Relay ←(WebSocket)→ Figma Plugin ``` ## Build & Development Commands ```bash bun install # Install dependencies

7k7mo agoDiscuss

airweave-aiCLAUDE.md

airweave

airweave-ai/airweave/CLAUDE.md

TypeScript, Vite, ShadCN UI, TailwindCSS - **Workers**: Temporal for async sync orchestration, Redis for pub/sub - **MCP Server** (`mcp/`): Node.js, Streamable HTTP transport for AI assistant integration Data flow: Sources → Entity extraction

6.6k6mo agoDiscuss

op7418CLAUDE.md

CodePilot

op7418/CodePilot/CLAUDE.md

只从当前 Worktree 启动，不得在其他目录启动 - 合并回主分支必须由用户主动发起，不得自动合并 - **端口隔离**：Worktree 启动 dev server 时使用非默认端口（如 `PORT=3001`），避免与主目录冲突 - **禁止跨目录编辑**：属于 Worktree 任务范围的文件，只在该 Worktree 内编辑，不得在主目录修改 - **合并前检查 untracked 文件**：合并回主分支前先 `git status

6.5k3mo agoDiscuss

SentryCLAUDE.md

XcodeBuildMCP

getsentry/XcodeBuildMCP/CLAUDE.md

applicable skills with `warden --skill `. - ## Multi-process filesystem state - MobileBuildMCP explicitly supports multiple concurrent MCP server, daemon, CLI, test, and helper processes for the same or different workspaces. - Shared filesystem

6.4k7d agoDiscuss

czlonkowskiCLAUDE.md

n8n-skills

czlonkowski/n8n-skills/CLAUDE.md

teach AI assistants how to build flawless n8n workflows using the n8n-mcp MCP server. **Repository**: https://github.com/czlonkowski/n8n-skills **Purpose**: 14 complementary skills that provide expert guidance on using

6.3k32d agoDiscuss

builderz-labsCLAUDE.md

mission-control

builderz-labs/mission-control/CLAUDE.md

sets `output: 'standalone'` ## Agent Control Interfaces Mission Control provides three interfaces for autonomous agents: ### MCP Server (recommended for agents) ```bash # Add to any Claude Code agent: claude mcp add mission

6.3k3mo 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.