brain-v42: Instructions file for Claude Code

CLAUDE.md

brain-v42 CLAUDE.md is an instructions file for Claude Code from hawkixs/brain-v42. It costs 8,783 tokens per session, scanned A, original, Apache-2.0.

Project instructions for brain-v42, a persistent memory server for coding agents. They describe how it runs, its database and vector search setup, and where live measurements and release information should be read.

In plain words
What is it for?
Use them when maintaining, deploying, or investigating the brain-v42 memory service and its database-backed search system.
Why use it?
They help agents distinguish stable rules from changing production facts, reducing the risk of following stale schema or deployment details.

Instructions file for Claude Code

Written for Claude Code: the file is CLAUDE.md. Also seen: reads .claude/ paths; mentions CLAUDE.md; mentions Claude Code.

This is hawkixs/brain-v42's own configuration. It tells Claude Code how to work on brain-v42 itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything brain-v42 configures →

Reuse

Borrowing it

Nothing to install: this file belongs to hawkixs/brain-v42. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/hawkixs/brain-v42/main/CLAUDE.md
Clone the repo
git clone --depth 1 https://github.com/hawkixs/brain-v42

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for brain-v42 CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/hawkixs/brain-v42/claude-md/github.svg)](https://agentmods.dev/instructions/hawkixs/brain-v42/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/hawkixs/brain-v42/claude-md"><img src="https://agentmods.dev/badge/instructions/hawkixs/brain-v42/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for brain-v42 CLAUDE.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/hawkixs/brain-v42/claude-md"><img src="https://agentmods.dev/badge/instructions/hawkixs/brain-v42/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 8,783 This file is loaded in full into every session.
When invoked 8,783 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.08783 $0.08783
Opus 5.5 $0.03513 $0.03513
Sonnet 5.5 $0.01757 $0.01757
Haiku 4.5 $0.00878 $0.00878

Measured 18d ago against content hash e1d93ce07fab, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

brain-v42 CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 18d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 643 lines

How it starts

The opening of the file, as written. The whole thing — 643 lines — stays where its author put it; the contents beside it link to each section on GitHub.

CLAUDE.md - brain_v42

Overview

Second Cerveau v42 — persistent memory for Claude Code over MCP.

  • Type: mcp-server
  • Stack: Python 3.12+, FastMCP 3.x, SQLAlchemy 2.0 async, asyncpg, Alembic, pgvector, httpx, Pydantic 2, structlog
  • Status: in active production; maintenance, hardening and ticket-driven work in progress

MCP transport: production (red-base) = HTTP on the host's WireGuard address (BIND_ADDRESS, port 8765, path /mcp) in credentials mode, every call authenticated; local HTTP (workstation/dev) = loopback http://127.0.0.1:8765/mcp (the configuration default bind); configuration default and dev/fallback transport = stdio.

Embedding topology: production uses hosted embeddings via deploy/compose.yaml (x-embedding-env: EMBEDDING_BACKEND=openai, Mistral codestral-embed-2505, 1536 dimensions). The local endpoint http://localhost:8003 is optional for development only; the former workstation deployment is retired.


⚠️ Living state does NOT live in this file

This document describes RULES and a SHAPE. Everything that can be measured lives in brain, or on the machine.

This is not a style preference, it is a correction. This file announced a wrong schema revision for ten days and a wrong killswitch for ten nights, and it contradicted itself on the same number three paragraphs apart — because it copied measurements. A document that copies a measurement cannot know it has aged: it stays green through the drift.

What you want to know Where to read it
Alembic head in production brain_fact_get("alembic_head")
Head shipped with the release brain_fact_get("alembic_head_shipped")
Live image release brain_fact_get("live_release_sha")
Declared Dream killswitches brain_fact_get("dream_killswitches_declared")
Last Dream night brain_fact_get("dream_last_night")
Last nightly claim verification brain_fact_get("claims_verification_last_night")
Graph projection lag brain_fact_get("graph_projection_lag")
Full catalogue of facts brain_fact_list
Focus, tickets, blockers, the night's failure the brain_session_start briefing
Decisions, learnings, snippets, runbooks, ADRs brain_search
State of an observable delivery brain_delivery_get / brain_delivery_list

Read the full file on GitHub · 643 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 18d ago Changed · +3 lines · +54 tokens per session e1d93ce07fab
  2. 20d ago Changed · +2 lines · +15 tokens per session f5b189319e3c
  3. 21d ago Changed · +7 tokens per session 54c71598d20f
  4. 23d ago Changed · +15 tokens per session 9e93808a7425
  5. 27d ago Changed 79a829564b24
  6. 1mo ago Changed 8345015d9516
  7. 1mo ago Changed · +4 lines · +313 tokens per session fddac90cfbac
  8. 1mo ago Changed · +18 lines · +581 tokens per session 16a038a15d4f
  9. 1mo ago Changed 2e772f1bd0fc
  10. 1mo ago First seen · 616 lines · 7,798 tokens per session scan A f7958b947faf

Subscribe to this mod's changes

brain-v42 CLAUDE.md is an instructions file published in the GitHub repository hawkixs/brain-v42 (3 stars, last pushed 19d ago), licensed Apache-2.0. It adds 8,783 tokens to every session, about $0.0351 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-23.

Related

brain-v42 CLAUDE.md compared with instructions from other repositories

brain-v42 CLAUDE.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
brain-v42 CLAUDE.mdhawkixs/brain-v42Instructions file319d agoApache-2.0A8,783Claude Code
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA9,719GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file143kyesterdayMITA7,461Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchainInstructions file149kyesterdayMITA4,680Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA5,516GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA3,093GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harnessInstructions file274k2d agoMITA4,313Codex, OpenCode