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

meta-questCLAUDE.md

agentic-tools

meta-quest/agentic-tools/CLAUDE.md

reference for Meta VR and Horizon OS development — installation, device setup, command discovery, MCP server mode, documentation search, app deployment, device testing setup, audio control, screenshots, and performance analysis

2007d agoDiscuss

blogminhquyCLAUDE.md

javis-os

blogminhquy/javis-os/CLAUDE.md

tools → Skill. If it is an external data source that already has a server → connect the MCP, do not write a plugin. - BEFORE creating anything: check for DUPLICATES. Read `Javis/index.md

19921d agoPipes a download into a shellDiscuss

FradSerCLAUDE.md

mcp-server-apple-events

FradSer/mcp-server-apple-events/CLAUDE.md

EventKit. ### Layer Structure ```text src/ ├── index.ts # Entry point: loads config, starts server ├── server/ │ ├── server.ts # MCP server setup with stdio transport │ ├── handlers.ts # Request handler registration (tools, prompts) │ ├── prompts.ts # Prompt template definitions

19743d agoDiscuss

mercurialsoloCLAUDE.md

claudectl

mercurialsolo/claudectl/CLAUDE.md

relay subcommands (serve, invite, join, discover, delegate, etc.) **Bus** (`src/bus/`): Agent-bus MCP server, durable role directory, and mailbox (feature-gated behind `bus`; see `docs/AGENT_BUS.md`). - `mod.rs` — module surface - `store.rs` — SQLite

1974mo agoDiscuss

gollem-devCLAUDE.md

gollem

gollem-dev/gollem/CLAUDE.md

interface: individual tools with `Spec()` and `Run()` methods - `ToolSet` interface: collections of tools (like MCP servers) - JSON Schema-based parameter validation **History Management** (`history.go`) - Cross-provider conversation history with versioning

1964mo agoReads credentialsDiscuss

posit-devCLAUDE.md

mcptools

posit-dev/mcptools/CLAUDE.md

Model Context Protocol. It ends "both sides" of the protocol—`mcp_server()` launches an MCP server, and `mcp_tools()` implements the client side. `mcp_session()` is an optional extension

19615mo agoDiscuss

ruvnetCLAUDE.md

QuDAG

ruvnet/QuDAG/CLAUDE.md

parallel`: Enable parallel execution - `--monitor`: Real-time monitoring - `--output `: json, sqlite, csv, html ### MCP Server Integration - `./claude-flow mcp start [--port 3000] [--host localhost]`: Start MCP server - `./claude-flow mcp status`: Show

19616mo agoDiscuss

MCP-ManagerCLAUDE.md

MCP-Checklists

MCP-Manager/MCP-Checklists/CLAUDE.md

MCP-Checklists Claude Context ## Repository Purpose This repository helps users self-host STDIO MCP servers remotely using a secure, containerized approach. It provides infrastructure and tooling to deploy MCP servers

19513mo agoReads credentialsDiscuss

TheBushidoCollectiveCLAUDE.md

han

TheBushidoCollective/han/CLAUDE.md

plugins (language/tool skills with validation hooks) - **do/** - Discipline plugins (specialized agents) - **hashi/** - Bridge plugins (MCP servers for external integrations) - **packages/han/** - CLI tool for plugin installation and management ## Development Commands ```bash

1956mo agoPipes a download into a shellDiscuss

maorccCLAUDE.md

gimp-mcp

maorcc/gimp-mcp/CLAUDE.md

Plugin** (`gimp-mcp-plugin.py`): A GIMP 3.2 plugin that starts a socket server inside GIMP 2. **MCP Server** (`gimp-mcp-server.py`): An MCP server that connects to the GIMP plugin and exposes GIMP functionality

1946mo agoDiscuss

77wliNdCLAUDE.md

aemeath_withclaude

77wliNd/aemeath_withclaude/CLAUDE.md

会话空闲 | | `/api/hook/permission` | PermissionRequest | 权限请求 | 工具状态映射：WebFetch→fetching, WebSearch→searching, Write/Edit→building, Agent/Task→analyzing ### 3. MCP Server (mcp.rs) **Tools（Claude → Pet）：** | 工具 | 功能 | |------|------| | `aemeath_show` | 显示自定义气泡 | | `aemeath_ask` | 向用户展示问题 | | `aemeath_play

1894mo agoDiscuss

patchorbitCLAUDE.md

domscribe

patchorbit/domscribe/CLAUDE.md

core) @domscribe/runtime — Browser-side context capture, framework adapters (depends on core) @domscribe/relay — Local HTTP/WS server + MCP server + CLI (depends on core, manifest) @domscribe/overlay — Lit web components

1886mo agoDiscuss

minipuftCLAUDE.md

claude-prompts-mcp

minipuft/claude-prompts-mcp/CLAUDE.md

catch this locally before a push. ## Node.js Support Boundaries | Surface | Supported Node.js | Enforcement | | -------------------------------- | ----------------- | ------------------------------------------------------------ | | MCP server and desktop extension | >=22.13.0 | `server/package.json`, `manifest.json`, CI on 22.13.0 and 24 | | Standalone

18739d 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.