agentleFS
Sign inSign up

CLAUDE.md examples from real projects

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

Most stars first · from page 9Worked for most · soon
ElasticCLAUDE.md

logstash

elastic/logstash/CLAUDE.md

See AGENTS.md.

15k6mo agoDiscuss
NVIDIACLAUDE.md

TensorRT-LLM

NVIDIA/TensorRT-LLM/CLAUDE.md

No summary in the file. Open it to read it.

15k45d agoDiscuss
walkinglabsCLAUDE.md

learn-harness-engineering

walkinglabs/learn-harness-engineering/CLAUDE.md

Learn Harness Engineering is a project-based course on building reliable coding environments for AI agents. The repo contains a VitePress documentation site plus hands-on project code. The course revolves around an Electron knowledge-base desktop app that evolves across the projects: - Main process (src/main/): Window management, IPC handlers, service initialization - Preload (src/preload/): contextBridge exposing typed API to renderer - Renderer (src/renderer/): React UI with document list, Q&A panel, status bar - Services (src/services/): DocumentService, IndexingService, QaService, PersistenceService - Shared…

15k6mo agoDiscuss
CoplayDevCLAUDE.md

unity-mcp

CoplayDev/unity-mcp/CLAUDE.md

MCP for Unity is a bridge that lets AI assistants (Claude, Cursor, Windsurf, etc.) control the Unity Editor through the Model Context Protocol (MCP). It enables AI-driven game development workflows - creating GameObjects, editing scripts, managing assets, running tests, and more. Two codebases, one system: - Server/ - Python MCP server using FastMCP - MCPForUnity/ - Unity C# Editor package The Python server has three distinct layers. These are not auto-generated from each other: MCP tools call Unity via WebSocket…

15k9mo agoDiscuss
e2b-devCLAUDE.md

E2B

e2b-dev/E2B/CLAUDE.md

Use pnpm for node and uv for python to install and update dependencies. Run pnpm run format, pnpm run lint and pnpm run typecheck before committing changes. When modifying the SDK packages, ensure equivalent changes are applied to both JS as well as sync and async Python implementations. Design the SDK in accordance with the design principles in TASTE.md. Never edit the API, envd, or volume-content specs in spec/ by hand; they are synced with Copybara from e2b-dev/runtime and e2b-dev/belt…

14k28d agoReads credentialsDiscuss
coleam00CLAUDE.md

context-engineering-intro / claude-code-full-guide

coleam00/context-engineering-intro/claude-code-full-guide/CLAUDE.md

This file provides comprehensive guidance to Claude Code when working with Python code in this repository. Simplicity should be a key goal in design. Choose straightforward solutions over complex ones whenever possible. Simple solutions are easier to understand, maintain, and debug. Avoid building functionality on speculation. Implement features only when they are needed, not when you anticipate they might be useful in the future. Follow strict vertical slice architecture with tests living next to the code they test: This project…

14k15mo agoPipes a download into a shellDiscuss
nanobrowserCLAUDE.md

nanobrowser

nanobrowser/nanobrowser/CLAUDE.md

This file provides guidance to AI coding assistants (e.g., Claude Code, GitHub Copilot, Cursor) when working with this repository. Nanobrowser is an open-source AI web automation Chrome extension that runs multi-agent systems locally in the browser. It's a free alternative to OpenAI Operator with support for multiple LLM providers (OpenAI, Anthropic, Gemini, Ollama, etc.). Package Manager: Always use pnpm (required, configured in Cursor rules) Core Commands: Targeted examples (fast path): - pnpm -F pages/side-panel build — build only the side…

14k18mo agoReads credentialsDiscuss
MicrosoftCLAUDE.md

playwright-cli

microsoft/playwright-cli/CLAUDE.md

Semantic commit messages: label(scope): description Labels: fix, feat, chore, docs, test, devops Never add Co-Authored-By agents in commit message. Branch naming for issue fixes: fix-<issue-number>

14k6mo agoDiscuss
Model Context ProtocolCLAUDE.md

typescript-sdk

modelcontextprotocol/typescript-sdk/CLAUDE.md

When making breaking changes, add to the relevant subsystem section in docs/migration/upgrade-to-v2.md (or docs/migration/support-2026-07-28.md if the change is 2026-07-28-only). Mechanical renames go in packages/codemod/src/migrations/v1-to-v2/mappings/ and the codemod handles them —…

13k3mo agoDiscuss
Model Context ProtocolCLAUDE.md

typescript-sdk / e2e

modelcontextprotocol/typescript-sdk/test/e2e/CLAUDE.md

Conformance-style tests for the SDK's public surface. requirements.ts is a pure-data manifest: every behavior the SDK must satisfy, with its spec/source link. Test files in scenarios/ cite the requirement id(s)…

13k3mo agoDiscuss
EverMind-AICLAUDE.md

EverOS

EverMind-AI/EverOS/CLAUDE.md

This is a Python framework for md-first memory extraction (lightweight; single-user or small-team). DDD 5 layers + cross-cutting: Dependency rule: entrypoints → service → memory → infra. Single-direction, enforced by import-linter. Detailed: docs/architecture.md. Contributor engineering reference — build, test, CI gates, branch & commit conventions: docs/engineering.md. main is the default and protected branch. Create scoped branches from main (feat/, fix/, docs/, ci/, chore/, refactor/) and open pull requests back to main after the required checks pass. See .claude/skills/new-branch/SKILL.md for the…

13k2mo agoDiscuss
Piebald-AICLAUDE.md

claude-code-system-prompts

Piebald-AI/claude-code-system-prompts/CLAUDE.md

System prompts extracted via script from the Claude Code npm package's compiled JavaScript source. Maintained by Piebald AI, not by Anthropic. See the Extraction section in README.md for details on the extraction method. Claude Code is Anthropic's CLI tool for agentic coding. It is distributed as a compiled npm package (@anthropic-ai/claude-code). Source code is not publicly available. The anthropics/claude-code GitHub repository contains issues and releases only.

13k8mo agoDiscuss
Wei-ShawCLAUDE.md

claude-relay-service

Wei-Shaw/claude-relay-service/CLAUDE.md

Claude Relay Service — 多平台 AI API 中转服务,作为客户端与上游 AI API 之间的中间件。 支持 Claude (官方/Console)、Gemini、OpenAI Responses、AWS Bedrock、Azure OpenAI、Droid、CCR 等账户类型。 核心能力:多账户管理、API Key 认证、统一调度、代理配置、限流、成本统计。 关键机制: - 粘性会话: 基于请求内容 hash 绑定账户,同一会话用同一账户 - 并发控制: Redis Sorted Set 实现,支持排队等待(非直接 429) - 529 处理: 自动标记过载账户,配置时长内排除 - 加密存储: 敏感数据(OAuth token、credentials)AES 加密存于 Redis - 流式响应: SSE 传输,实时捕获 usage,客户端断开时 AbortController 清理资源

13k6mo agoReads credentialsDiscuss
corsairdevCLAUDE.md

corsair

corsairdev/corsair/CLAUDE.md

Corsair is an open-source integration layer for agents (~70 plugin packages). - packages/<plugin>/ — one integration each (slack, gmail, …). Everything except corsair, cli, mcp, studio, ui, app is a…

13k54d agoDiscuss
zilliztechCLAUDE.md

claude-context

zilliztech/claude-context/CLAUDE.md

Claude Context is an MCP plugin that adds semantic code search to AI coding agents. A codebase is split into chunks, embedded, and stored in a Milvus/Zilliz vector database; queries are answered by semantic (hybrid dense + sparse) search instead of loading whole directories into the model's context. pnpm workspace (packages/, examples/). Requires Node >=20 <24 and pnpm >=10. Packages depend on core via workspace:, so *rebuild core (pnpm build:core) before testing mcp/vscode against core changes** — they consume core/dist,…

12k14mo agoReads credentialsDiscuss
Untrivial-aiCLAUDE.md

agent-orchestrator

Untrivial-ai/agent-orchestrator/CLAUDE.md

Read and follow AGENTS.md for repository layout, commands, coding conventions, and hard rules. All app state, the daemon's data dir, running.json, worktrees, and the Electron supervisor's userData (Chromium cache, cookies, local/session storage, crash dumps), must resolve under ~/.ao (overridable via AODATADIR/AORUNFILE). Never write to or read from ~/Library/Application Support or any other OS-default app-data location. frontend/src/main.ts pins Electron's userData to ~/.ao/electron; do not remove that override. See the hard rule in AGENTS.md. Always read DESIGN.md before making any visual or…

12k14d agoDiscuss
mrexodiaCLAUDE.md

ida-pro-mcp

mrexodia/ida-pro-mcp/CLAUDE.md

Guidance for working in this repository. IDA Pro MCP Server: exposes IDA Pro / idalib functionality to MCP clients. Main pieces: - src/idapromcp/server.py: MCP server entrypoint - src/idapromcp/idalibserver.py: headless idalib server - src/idapromcp/idamcp/: IDA/plugin-side APIs Important API modules: - apicore.py: IDB metadata, functions, strings, imports - apianalysis.py: decompilation, disassembly, xrefs, paths, pattern search - apimemory.py: bytes/ints/strings, patching - apitypes.py: structs, type inference, type application - apimodify.py: comments, renaming, asm patching - apistack.py: stack frame operations - apisigmaker.py: signature creation, scanning,…

12k2mo agoDiscuss
Orchestra-ResearchCLAUDE.md

AI-Research-SKILLs

Orchestra-Research/AI-Research-SKILLs/CLAUDE.md

AI Research Skills Library - A comprehensive open-source library of 98 AI research skills enabling AI agents to autonomously conduct AI research — from idea to paper. Each skill provides expert-level guidance (200-500 lines) with real code examples, troubleshooting guides, and production-ready workflows. Mission: Enable AI agents to autonomously conduct AI research from hypothesis to experimental verification, covering the full lifecycle: literature survey, ideation, dataset preparation, training pipelines, model deployment, evaluation, and paper writing. Skills are organized into numbered categories…

12k4mo 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.