/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:
- Identify target memories — Find all memories matching the target query
- Trace references — Scan all other memories for references to the target (in content, related fields, tags)
- Trace association links — Find all edges in
associations.jsonthat connect to target memories - Trace index entries — Find all entries in
index.jsonand any_meta.jsonfiles - Present the erasure plan — Show everything that will be affected and ask for confirmation
- Execute erasure — Remove target memories, clean references from other memories, delete association links, update indexes
- Verify completeness — Scan again to confirm no traces remain
What Gets Removed
| Component | Action |
|---|---|
| Target memory files | Permanently deleted |
| References in other memories | Content mentioning the target is edited out |
related fields | Target memory IDs removed from other memories' related lists |
| Association edges | All edges to/from target memories are deleted |
| Index entries | Removed from index.json and _archived/index.json |
_meta.json entries | Category statistics updated |
| Review queue | Target memories removed from review-queue.json |
| Contexts | References 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
Sunshine erasure is permanent and cannot be undone (unless ~/.brain/ is under Git version control). Always review the erasure plan carefully before confirming.
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 | |
|---|---|---|
| Scope | Single memory | All traces of a topic |
| References | Left intact in other memories | Traced and removed |
| Associations | Deactivated | Fully deleted |
| Reversibility | Archive option available | Permanent only |
| Use case | One outdated memory | Complete topic erasure |