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 10Worked for most · soon
BeehiveInnovationsCLAUDE.md

pal-mcp-server

BeehiveInnovations/pal-mcp-server/CLAUDE.md

This file contains essential commands and workflows for developing and maintaining the PAL MCP Server when working with Claude. Use these instructions to efficiently run quality checks, manage the server,…

12k13mo agoReads credentialsDiscuss
MemTensorCLAUDE.md

MemOS

MemTensor/MemOS/CLAUDE.md

Project facts live in AGENTS.md. This file only covers Claude Code runtime adaptation. Five project-recommended sub-agents live under .claude/agents/*.md. Claude Code loads them automatically; the main agent should dispatch by task boundary: The main repo has no frontend stack, so no frontend-dev is provided; TypeScript sub-projects under apps/ use their own AI configuration. Before starting a task, run ls docs/. docs/openapi.json is the source of truth for the API contract; after touching src/memos/api/, run make openapi to regenerate it.

12k4mo agoDiscuss
cocoindex-ioCLAUDE.md

cocoindex

cocoindex-io/cocoindex/CLAUDE.md

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

12k3mo agoDiscuss
0xJackyCLAUDE.md

nginx-ui

0xJacky/nginx-ui/CLAUDE.md

This project is a web-based NGINX management interface built with Go backend and Vue.js frontend.

12k11d agoDiscuss
humanlayerCLAUDE.md

humanlayer

humanlayer/humanlayer/CLAUDE.md

This is a monorepo containing two distinct but interconnected project groups: Project 1: HumanLayer SDK & Platform - The core product providing human-in-the-loop capabilities for AI agents Project 2: Local…

11k12mo agoDiscuss
humanlayerCLAUDE.md

humanlayer / workflows

humanlayer/humanlayer/.github/workflows/CLAUDE.md

Focus on one optimization at a time. Remove branch from triggers before merging.

11k12mo agoDiscuss
humanlayerCLAUDE.md

humanlayer / hld

humanlayer/humanlayer/hld/CLAUDE.md

This is the humanlayer Daemon (HLD) that powers the WUI (humanlayer-wui) You cannot run this process, you cannot restart it. If you make changes, you must ask the user to…

11k12mo agoDiscuss
humanlayerCLAUDE.md

humanlayer / humanlayer-wui

humanlayer/humanlayer/humanlayer-wui/CLAUDE.md

This is the HumanLayer Web UI (WUI) - a desktop application for managing AI agent approvals and sessions. The WUI connects to the HumanLayer daemon (hld) to provide a graphical…

11k12mo agoDiscuss
humanlayerCLAUDE.md

humanlayer / scripts

humanlayer/humanlayer/scripts/CLAUDE.md

Default to using Bun instead of Node.js. Use bun test to run tests. Use HTML imports with Bun.serve(). Don't use vite. HTML imports fully support React, CSS, Tailwind. HTML files…

11k12mo agoReads credentialsDiscuss
JeffallanCLAUDE.md

claude-skills

Jeffallan/claude-skills/CLAUDE.md

This file governs Claude's behavior when working on the claude-skills repository. Skills follow the Agent Skills specification. This section covers project-specific conventions that go beyond the base spec. Critical: Never put process steps or workflow sequences in descriptions. When descriptions contain step-by-step instructions, agents follow the brief description instead of reading the full skill content. This defeats the purpose of detailed skills. Brief capability statements (what it does) and trigger conditions (when to use it) are both appropriate. Process steps…

11k9mo agoDiscuss
holaboss-aiCLAUDE.md

holaOS

holaboss-ai/holaOS/CLAUDE.md

The local Electron 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 fits the wider Holaboss product. scripts/hola.mts runs…

11k2mo agoReads credentialsDiscuss
Hugging FaceCLAUDE.md

chat-ui

huggingface/chat-ui/CLAUDE.md

Chat UI is a SvelteKit application that provides a chat interface for LLMs. It powers HuggingChat (hf.co/chat). The app speaks exclusively to OpenAI-compatible APIs via OPENAIBASEURL. Tests are split into three workspaces (configured in vite.config.ts): MCP servers are configured via MCPSERVERS env var. When enabled, tools are exposed as OpenAI function calls. The router can auto-select tools-capable models when LLMROUTERENABLETOOLS=true. Smart routing via Arch-Router model. Configured with: Copy .env to .env.local and configure: See .env for full list of variables…

11k50d agoReads credentialsDiscuss
Model Context ProtocolCLAUDE.md

inspector

modelcontextprotocol/inspector/CLAUDE.md

@./AGENTS.md

11k8d agoDiscuss
zubair-trabzadaCLAUDE.md

geo-seo-claude

zubair-trabzada/geo-seo-claude/CLAUDE.md

A GEO-SEO analysis toolkit distributed as a suite of Claude Code skills + subagents + Python scripts. "GEO" = Generative Engine Optimization — optimizing websites for AI search engines (ChatGPT, Claude, Perplexity, Gemini, Google AI Overviews) rather than only traditional search. Philosophy: GEO-first, SEO-supported. This repo is the source. Users install it into ~/.claude/ (see install), then invoke /geo <command> <url> inside Claude Code. Audits are run from the user's own working directory and deliverables land there — never in…

11k57d agoDiscuss
LangChainCLAUDE.md

open-swe

langchain-ai/open-swe/CLAUDE.md

See AGENTS.md for OpenWiki agent instructions.

11k8d agoDiscuss
mcp-useCLAUDE.md

mcp-use

mcp-use/mcp-use/docs/CLAUDE.md

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

11k12mo agoDiscuss
omnigent-aiCLAUDE.md

omnigent / triage_v2

omnigent-ai/omnigent/.github/triage_v2/CLAUDE.md

This project uses Declarative Automation Bundles for deployment. Install the Databricks CLI 0.292.0 or newer and verify with databricks -v. Read the databricks-core skill for CLI, authentication, and deployment workflow. Read the databricks-jobs skill for job-specific guidance.

10k9d agoDiscuss
JetBrainsCLAUDE.md

ideavim

JetBrains/ideavim/CLAUDE.md

Guidance for Claude Code when working with IdeaVim. Essential commands: - ./gradlew runIde - Start dev IntelliJ with IdeaVim - ./gradlew test -x :tests:property-tests:test -x :tests:long-running-tests:test - Run standard tests Avoid running all tests, this takes too long. It's preferred to run specific test. When running gradle tasks, use --console=plain for cleaner output without progress bars. See CONTRIBUTING.md for architecture details and a complete command list. This project uses YouTrack for issue tracking, NOT GitHub Issues. - Tickets are prefixed…

10k2mo agoDiscuss
ykdojoCLAUDE.md

claude-code-tips

ykdojo/claude-code-tips/CLAUDE.md

For issues against anthropics/claude-code. When I ask you to file one: - Draft it to a temp file and open it in VS Code (code <file>) for me to review…

10k36d agoDiscuss
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.