CLAUDE.md examples from real projects

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

Best matchesWorked for most · soon

lobehubCLAUDE.md

lobehub / e2e

lobehub/lobehub/e2e/CLAUDE.md

目录运行 cd e2e # 运行特定标签的测试 BASE_URL=http://localhost:3006 \ DATABASE_URL=postgresql://postgres:postgres@localhost:5433/postgres \ pnpm exec cucumber-js --config cucumber.config.js --tags "@AGENT-CHAT-001" # 调试模式（显示浏览器） HEADLESS=false

83k6d agoDiscuss

topoteretesCLAUDE.md

cognee

topoteretes/cognee/CLAUDE.md

dependencies uv pip install -e ".[dev]" # Install with specific extras uv pip install -e ".[postgres,neo4j,docs]" # Set up pre-commit hooks pre-commit install ``` ### Available Installation Extras - **postgres** / **postgres

31k16d agoReads credentialsDiscuss

alirezarezvaniCLAUDE.md

claude-skills

alirezarezvani/claude-skills/CLAUDE.md

# CLAUDE.md This file provides guidance to Claude Code (claude.ai/code) when working with code

25k5mo agoReads credentialsDiscuss

microCLAUDE.md

go-micro

micro/go-micro/CLAUDE.md

Client-side load balancing ├── server/ # RPC server ├── service/ # Service interface + profiles ├── store/ # Data persistence (Postgres, NATS KV) ├── transport/ # Network transport ├── wrapper/ # Middleware (auth, trace, metrics) ├── examples/ # Working examples └── internal

23k3mo agoDiscuss

CannerCLAUDE.md

WrenAI

Canner/WrenAI/.claude/CLAUDE.md

with all optional extras (incl. memory) just install-extra # e.g. just install-extra postgres just install-memory # memory extra (lancedb + sentence-transformers) just install-local # engine dev: uv sync + build

18k21mo agoDiscuss

open-metadataCLAUDE.md

OpenMetadata

open-metadata/OpenMetadata/CLAUDE.md

generated/**` — regen, never hand-edit generated | | `migrations.md` | `bootstrap/sql/**` — append-only, native path, MySQL+Postgres, idempotent | ### Repo coding conventions (read before writing non-trivial code) - `docs/design-patterns.md` — the design patterns this codebase

15k31d agoDiscuss

JetBrainsCLAUDE.md

Exposed

JetBrains/Exposed/CLAUDE.md

/gradlew :exposed-r2dbc-tests:test_h2_v2 # R2DBC Tests with H2 ``` #### Test with Postgres ```bash ./gradlew test_postgres # All modules with Postgres ./gradlew :exposed-tests:test_postgres # JDBC Tests with

9.3k6mo agoDiscuss

plastic-labsCLAUDE.md

honcho

plastic-labs/honcho/CLAUDE.md

multi-row `SELECT ... FOR UPDATE` MUST carry an explicit `ORDER BY `.** Without it Postgres locks in scan order, which differs per plan, so two writers with overlapping sets can cycle

7.4k40d agoReads credentialsDiscuss

weave-osCLAUDE.md

router

weave-os/router/CLAUDE.md

5.4k19d agoDiscuss

SupabaseCLAUDE.md

supabase-js

supabase/supabase-js/.claude/CLAUDE.md

Package | Docker Required | Infrastructure | Complete Test Command | Individual Commands | | ------------ | --------------- | ------------------------------- | ----------------------------------- | ----------------------------------------------------------------------------------------- | | auth-js | ✅ Yes | Auth Server + Postgres | `nx test:auth auth-js` | `nx test:suite auth-js`, `nx test:infra auth

4.6k6mo agoDeletes or force-pushesDiscuss

archestra-aiCLAUDE.md

archestra / ai-labs

archestra-ai/archestra/ai-labs/CLAUDE.md

other container env vars — feature flags — do flow through). Gotchas: the bench resolves its Postgres from `ARCHESTRA_BENCH_DATABASE_URL` and creates

4.3k6d agoReads credentialsDiscuss

melgarafaelCLAUDE.md

DeskcommCRM

melgarafael/DeskcommCRM/CLAUDE.md

Backend:** Next.js Route Handlers (mesmo repo); workers via `event_log` table + cron - **DB:** Supabase (Postgres). RLS em toda tabela tenant-aware. Extensions: `uuid-ossp`, `pgcrypto`, `vector` - **Auth:** Supabase Auth

4.2k15d agoReads credentialsDiscuss

bethingtonCLAUDE.md

ghidra-mcp

bethington/ghidra-mcp/CLAUDE.md

# Ghidra MCP - Claude Code Guide ## Overview MCP server bridging Ghidra reverse engineering with AI

4k9d agoReads credentialsDiscuss

bytebaseCLAUDE.md

dbhub

bytebase/dbhub/CLAUDE.md

follows a modular architecture centered around the MCP protocol: ``` src/ ├── connectors/ # Database-specific implementations │ ├── postgres/ # PostgreSQL connector │ ├── mysql/ # MySQL connector │ ├── mariadb/ # MariaDB connector │ ├── sqlserver/ # SQL Server connector │ ├── oracle/ # Oracle connector

3.6k14d agoReads credentialsDiscuss

AgentsMeshCLAUDE.md

AgentsMesh

AgentsMesh/AgentsMesh/CLAUDE.md

2.4k2mo agoReads credentialsDiscuss

InfisicalCLAUDE.md

agent-vault

Infisical/agent-vault/CLAUDE.md

agents how to create proposals when API access is needed. - **Dual database backend (SQLite / Postgres)**: By default, all state lives in a single SQLite file (`~/.agent-vault/agent-vault.db` or `/data/.agent-vault/agent-vault.db` in Docker

2.3k6mo agoReads credentialsDiscuss

agno-agiCLAUDE.md

dash

agno-agi/dash/CLAUDE.md

scheduler, Slack interface) └── config.yaml # Quick prompts db/ ├── __init__.py # Re-exports: db_url, get_postgres_db, get_sql_engine, etc. ├── session.py # PostgreSQL + PgVector + dual schema (public/dash) └── url.py # Database URL builder

2.3k6mo agoReads credentialsDiscuss

yoanbernabeuCLAUDE.md

grepai

yoanbernabeu/grepai/CLAUDE.md

Configuration Configuration stored in `.grepai/config.yaml`. Key options: - `embedder.provider`: "ollama" or "openai" - `store.backend`: "gob" or "postgres" - `chunking.size`/`chunking.overlap`: Token-based chunking parameters ## Adding New Backends **New embedder:** Implement `Embedder` interface

1.9k9mo agoDiscuss

zzetCLAUDE.md

gortex

zzet/gortex/CLAUDE.md

external extractor plugin (`index.extractor_plugins`) from config — no fork. `gortex db schema --postgres ` ingests a live database's schema. - **`analyze` is a 61-kind dispatcher** — beyond the structural kinds

1.8k6mo agoReads credentialsDiscuss

SupabaseCLAUDE.md

postgres

supabase/postgres/CLAUDE.md

used by local dev / the Supabase CLI. 2. **AWS AMIs** — the production Supabase-hosted Postgres image, built via Nix + Packer + Ansible. 3. **Nix packages** — `nix build .#psql_15.bin` etc., the underlying

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