Skip to content

choaticpixels/wicked-brain

v0.1.0MIT

Plain-markdown memory vault for Codex: recall, save and maintain notes about projects, decisions, sessions and concepts, with ranked search, duplicate detection, freshness checks and optional encrypted cross-device sync.

brain-capture

Quick capture - zero friction, saves a fact, pattern, or idea to concepts/ and links it from today's session note Triggers: remember that, capture this, note this down, keep this in mind. Use proactively: trigger this whenever the conversation produces something worth capturing, without waiting to be asked.

brain-find

Smart memory search - returns results with context, not just filenames Triggers: find in memory, search my memory, where is, what did I tell you about, what do you remember about. Use only when the user explicitly asks for it.

brain-fork

Fork a project note - duplicate it under a new name, linked back to the original, so a derivative project starts with real context instead of a blank page Triggers: fork this project, clone this project in memory, start a project based on. Use only when the user explicitly asks for it.

brain-health

Run a memory health check - grouped by severity, detects duplicates, contradictions, stale claims, and structural issues Triggers: memory health, check the vault, audit my memory, memory diagnostics. Use only when the user explicitly asks for it.

brain-init

Bootstrap a new memory vault - fixed folder structure, operating manuals for both Claude Code and Codex CLI, index.md, CRITICAL_FACTS.md Triggers: init memory, bootstrap vault, set up my memory, create a new vault. Use only when the user explicitly asks for it.

brain-merge

Merge two near-duplicate notes found by /brain-health into one - dry run by default, redirects the retired note rather than deleting it Triggers: merge these notes, merge duplicates, combine these two notes. Use only when the user explicitly asks for it.

brain-reconcile

Find and resolve contradictions in the vault - the memory maintains its own truth Triggers: find contradictions, reconcile my memory, fix conflicting facts. Use only when the user explicitly asks for it.

brain-reindex

Refresh the vault's semantic search index and report coverage before and after Triggers: reindex memory, rebuild semantic index, refresh semantic search. Use only when the user explicitly asks for it.

brain-save

Save everything worth remembering from this conversation to the memory vault Triggers: save this, save the conversation, save to memory, remember this. Use proactively: trigger this whenever the conversation produces something worth capturing, without waiting to be asked.

brain-setup

Connect the Wicked Brain plugin to a memory vault: records the vault location for the MCP server and skills, checks that search works, and offers to create the vault. Run once after installing, or whenever brain search says the vault is not configured. Triggers: set up wicked brain, connect my vault, brain setup.

brain-sync

Sync the vault across your devices - push local changes, pull remote ones, and report any genuine conflicts Triggers: sync my memory, sync the vault, push my notes, pull my notes. Use only when the user explicitly asks for it.

wicked-brain

Operating rules for the user's Wicked Brain memory vault (plain-markdown notes shared by Claude Code, Codex and Antigravity). Use whenever the task is to recall, save, or maintain notes about projects, decisions, people, sessions or concepts, or when a $brain-* skill is invoked.