Brainmaxxing

Brainmaxxing (Claude Code plugin)

Stupid simple persistent memory for Claude Code, packaged as a plugin. A markdown vault (brain/) in your project that your agent reads at session start and writes to when it learns something. It's also an Obsidian vault, so you can browse your agent's memory yourself.

This is a plugin repackaging of poteto/brainmaxxing. It ships the six skills and the two hooks — it does not seed the 16 starter principles. Your brain starts empty and grows from /reflect.

Skills

Four form a learning loop — reflect after sessions, ruminate over past conversations, meditate to audit and prune. Two support structured work — plan for phased plans, review for principle-grounded review. The brain skill handles direct read/write of the vault.

• /reflect — scan the conversation for things worth remembering and write them to brain/. Most of your brain content comes from this.
• /meditate — audit the vault against your skills, find contradictions, prune stale notes, surface unstated principles.
• /ruminate — mine past Claude Code conversations for patterns /reflect missed. Good for bootstrapping from existing history.
• /plan — break a medium-to-large task into phased plans in brain/plans/. Planning only.
• /review — principle-grounded review of code or plans. Review only.
• /brain — read/write the vault directly.
• /init-brain — scaffold the brain/ folder and index.md in a new project. Optional — the vault is also created on demand by /reflect.

Hooks

Two hooks handle the plumbing, scoped to your project ($CLAUDE_PROJECT_DIR/brain/):

• SessionStart — injects brain/index.md so the agent knows what knowledge is available. No-ops until the vault exists.
• PostToolUse (Write|Edit|MultiEdit) — rebuilds brain/index.md when files under brain/ are added or removed. Bootstraps the index on the first write.

The original repo also appended brain read/write rules to your CLAUDE.md. As a plugin that's covered instead by the SessionStart hook (read-first) and the brain skill (write/maintain), so there's nothing to merge into your project.

Installation

Add the marketplace and install:

/plugin marketplace add alexanderop/brainmaxxing-plugin
/plugin install brainmaxxing@brainmaxxing

Or run a working tree directly without installing:

claude --plugin-dir /path/to/brainmaxxing-plugin -p "<prompt>"

Optionally run /init-brain once to scaffold the brain/ folder up front. Otherwise the vault is created on demand the first time /reflect (or /brain) writes to it — no setup step required either way.

License

MIT. Original work by Lauren Tan (poteto/brainmaxxing). Plugin packaging maintained by Alexander Opalic.