hebb-mind CLAUDE.md

hebb-mind CLAUDE.md is an instructions file for coding agents from afx-team/hebb-mind. It costs 1,046 tokens per session, scanned A, original, MIT.

Project instructions for Hebb Mind, a neuroscience-inspired memory system for AI agents. They describe its code areas, public documentation boundary, and evaluation setup.

In plain words
What is it for?
Use it when working on Hebb Mind's Python package, command-line tool, server, web console, integrations, documentation, or evaluations.
Why use it?
The project contains both public website content and private research material, so contributors need to know what can be published. The instructions also clarify where benchmarks and project rules belong.

Instructions file

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/afx-team/hebb-mind/claude-md
Clone the repo
git clone --depth 1 https://github.com/afx-team/hebb-mind

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 hebb-mind CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/afx-team/hebb-mind/claude-md.svg)](https://agentmods.dev/instructions/afx-team/hebb-mind/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/afx-team/hebb-mind/claude-md"><img src="https://agentmods.dev/badge/instructions/afx-team/hebb-mind/claude-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 1,046 This file is loaded in full into every session.
When invoked 1,046 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
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 $0.01046 $0.01046
Opus 5 $0.00523 $0.00523
Sonnet 5 $0.00209 $0.00209
Haiku 4.5 $0.00105 $0.00105

Measured 5d ago against content hash ffcf3be69fae, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

hebb-mind 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 5d 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 · 93 lines

How it starts

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

Hebb Mind

Neuroscience-inspired memory framework for AI agents. Open-source under github.com/afx-team, distributed on PyPI as hebb-mind.


Priority Hierarchy

When rules conflict, follow this priority order:

  1. MUST — Non-negotiable constraints (违反则输出无效)
  2. SHOULD — Strong recommendations (默认遵守,可明确说明理由后偏离)
  3. MAY — Optional suggestions (视具体情况采用)

Project Context

Status: Production (PyPI hebb-mind) Domain: Long-term memory for LLM agents — write, consolidate, recall, forget Surfaces: Python package, Click CLI (hebb), FastAPI server, MCP server (stdio), web console, Claude Code + Codex integrations Docs site: VitePress → GitHub Pages at https://afx-team.github.io/hebb-mind/


Publication Boundary

  • repo_pages/ is the public website (VitePress → GitHub Pages). User-facing docs go here. Never commit secrets, internal analysis, or proprietary data — anything merged is published.
  • reports/ is internal-only (papers, analysis, design, surveys). Research notes, audits, and design drafts go here, not in repo_pages/.

Evaluation & Benchmarks

The benchmark harness lives in eval/ — datasets, metrics, CLI, and report layout are documented in eval/README.md (read it before running or updating evals). Must-know invariants:

  • Each benchmark runs against an isolated server (own port 8401–8409, own workdir hebb.db) — never the daily hebb service on 8321.
  • Match the metric to the dataset's ground truth — session Recall@k / Hit@k where a clean evidence id exists; end-to-end QA only otherwise. LongMemEval QA uses the official reader + get_anscheck_prompt judge verbatim (no benchmark-tuned prompts).
  • A published number in repo_pages/benchmarks/ MUST cite an in-tree run-N report; update the EN page and its zh/ mirror together.

User Path Ownership (MUST)

The user's complete path — install → first command → background operation → uninstall — is the product. Every crossing between environments (shell ↔ GUI app ↔ launchd ↔ systemd ↔ Task Scheduler ↔ a third-party CLI's subprocess) is the framework's responsibility, never the user's.

Read the full file on GitHub · 93 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. 5d ago First seen · 93 lines · 1,046 tokens per session scan A ffcf3be69fae

Subscribe to this mod's changes

hebb-mind CLAUDE.md is an instructions file published in the GitHub repository afx-team/hebb-mind (51 stars, last pushed 1mo ago), licensed MIT. It adds 1,046 tokens to every session, about $0.0052 per session on Opus 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-08-30.