/brain:explore

Browse the brain hierarchy with a visual tree view. See what memories exist, where they are stored, and their current strength.

Usage

/brain:explore [category]

Arguments:

[category] — (Optional) A specific category or path to explore (e.g., professional, personal/education). If omitted, shows the top-level overview.

What It Does

/brain:explore gives you a visual map of your brain's directory structure. Each memory is shown with its current effective strength, so you can see at a glance which areas of knowledge are strong and which are fading.

Example Interactions

Top-level overview

User: /brain:explore

Agent: 🧠 Brain Overview

~/.brain/
├── professional/              14 memories | avg strength: 0.72
│   ├── companies/
│   │   └── acme-corp/          8 memories
│   ├── skills/                 4 memories
│   └── career/                 2 memories
├── personal/                   6 memories | avg strength: 0.58
│   ├── education/              3 memories
│   ├── health/                 1 memory
│   └── goals/                  2 memories
├── social/                     3 memories | avg strength: 0.45
│   └── communities/            3 memories
├── family/                     2 memories | avg strength: 0.61
│   └── events/                 2 memories
├── _consolidated/              1 memory
└── _archived/                  5 memories

Total: 26 active memories | 5 archived | 1 consolidated

Exploring a specific category

User: /brain:explore professional/companies/acme-corp

Agent: 🧠 professional/companies/acme-corp/

├── projects/
│   └── alpha/
│       ├── architecture-decision.md       ⚡ 0.82  decision
│       ├── kafka-setup.md                 ⚡ 0.68  learning
│       └── deploy-incident-mar5.md        ⚡ 0.45  experience
│   └── beta/
│       ├── tech-stack-choice.md           ⚡ 0.71  decision
│       └── api-design.md                  ⚡ 0.63  decision
├── decisions/
│   ├── monorepo-adoption.md               ⚡ 0.78  decision
│   └── event-sourcing.md                  ⚡ 0.55  insight
└── team/
    └── platform-team-contacts.md          ⚡ 0.60  relationship

8 memories | avg strength: 0.65
Strongest: architecture-decision.md (0.82)
Weakest: deploy-incident-mar5.md (0.45)

What You Can Learn

Exploring your brain helps you:

Find knowledge gaps — Areas with few memories or low average strength
Identify fading memories — Memories that need a recall or review before they decay further
Understand organization — See how the agent has structured your knowledge
Discover forgotten areas — Categories you have not visited in a while
Plan consolidation — Spot clusters of weak related memories that could be merged

Tip

If you notice memories with very low strength (below 0.3), consider running /brain:remember to recall them (which strengthens them) or /brain:consolidate to merge weak related memories into stronger ones.

Viewing Archived Memories

You can also explore the archive:

User: /brain:explore _archived

Agent: 🧠 _archived/

├── old-project-setup.md                   ⚡ 0.08  learning
├── initial-db-schema-notes.md             ⚡ 0.05  observation
├── sprint-3-retro-notes.md                ⚡ 0.03  experience
├── early-api-design.md                    ⚡ 0.06  decision
└── temp-workaround.md                     ⚡ 0.02  observation

5 archived memories
These memories have decayed below the archive threshold (0.1).
They are still searchable via /brain:remember as a fallback.

Info

Archived memories are not gone — they have been moved to _archived/ because their strength dropped below 0.1 during a sleep cycle. They can still be found by /brain:remember when no active matches exist, and recalling them moves them back to an active location with a strength boost.