/brain:sunshine

Deep forensic erasure that traces and removes all references to a memory or topic. Named after the film "Eternal Sunshine of the Spotless Mind" — this command erases a memory as thoroughly as possible.

Usage

/brain:sunshine [target]

Arguments:

  • [target] — A memory ID, topic description, or keyword to identify what to erase. The agent traces all references before confirming.

What It Does

Unlike /brain:forget which handles a single memory, /brain:sunshine performs a complete forensic erasure:

  1. Identify target memories — Find all memories matching the target query
  2. Trace references — Scan all other memories for references to the target (in content, related fields, tags)
  3. Trace association links — Find all edges in associations.json that connect to target memories
  4. Trace index entries — Find all entries in index.json and any _meta.json files
  5. Present the erasure plan — Show everything that will be affected and ask for confirmation
  6. Execute erasure — Remove target memories, clean references from other memories, delete association links, update indexes
  7. Verify completeness — Scan again to confirm no traces remain

What Gets Removed

ComponentAction
Target memory filesPermanently deleted
References in other memoriesContent mentioning the target is edited out
related fieldsTarget memory IDs removed from other memories' related lists
Association edgesAll edges to/from target memories are deleted
Index entriesRemoved from index.json and _archived/index.json
_meta.json entriesCategory statistics updated
Review queueTarget memories removed from review-queue.json
ContextsReferences in contexts.json are cleaned

Example Interaction

User: /brain:sunshine project-beta client data

Agent: 🔍 Tracing all references to "project-beta client data"...

Found the following traces:

Target memories (will be deleted):
  1. professional/companies/acme/projects/beta/client-data-schema.md
  2. professional/companies/acme/projects/beta/client-migration-plan.md

References in other memories (will be edited):
  3. professional/companies/acme/decisions/data-architecture.md
     → Line 24: "See also the client data schema in project-beta"
     → related: [mem_20260301_client_data]
  4. professional/skills/postgresql/jsonb-patterns.md
     → Line 12: "Used in project-beta's client data migration"

Association links (will be removed):
  5. mem_20260301_client_data ↔ mem_20260215_architecture (weight: 0.45)
  6. mem_20260301_client_data ↔ mem_20260305_migration (weight: 0.38)
  7. mem_20260305_migration ↔ mem_20260210_postgresql (weight: 0.22)

Index entries: 2 in index.json, 0 in archive

Total: 2 memories deleted, 2 memories edited, 3 links removed

⚠️ This operation cannot be undone. Proceed? (yes/no)

User: yes

Agent: ✅ Sunshine complete.
  • 2 memories permanently deleted
  • 2 memories edited (references removed)
  • 3 association links deleted
  • Index updated

Verification scan: no remaining traces found.

When to Use Sunshine

Use /brain:sunshine when you need to completely remove a topic from your brain:

  • Confidential information — Client data, credentials, or proprietary details that should not persist
  • Incorrect knowledge — A misunderstanding that has propagated into multiple memories
  • Former projects — Complete cleanup when you are done with a project and want no lingering references
  • Personal information — Removing sensitive personal details from the brain
Danger

Sunshine erasure is permanent and cannot be undone (unless ~/.brain/ is under Git version control). Always review the erasure plan carefully before confirming.

Info

Sunshine models targeted forgetting in the brain — the ability to selectively erase specific memory traces while leaving the rest of the network intact. The reference cleanup ensures no "dangling pointers" remain in your associative network.

Sunshine vs. Forget

/brain:forget/brain:sunshine
ScopeSingle memoryAll traces of a topic
ReferencesLeft intact in other memoriesTraced and removed
AssociationsDeactivatedFully deleted
ReversibilityArchive option availablePermanent only
Use caseOne outdated memoryComplete topic erasure