Agent skill
brain
Launch the Brain Visualizer, a real-time 3D view of memory and relationships. Triggers on "show your brain", "visualize memory", "open the brain", "memory graph".
Install this agent skill to your Project
npx add-skill https://github.com/kbanc85/claudia/tree/main/template-v2/.claude/skills/brain
SKILL.md
Brain
Launch the Claudia Brain Visualizer, a real-time 3D cosmos visualization of my memory system showing entities, relationships, memories, and patterns as a swirling interactive force-directed graph.
Triggers: /brain, "show me your brain", "visualize memory", "open the brain", "memory graph"
Overview
The visualizer is a single Express server (server.js) in ~/.claudia/visualizer/ that serves both the API (reads SQLite directly) and the pre-built 3D frontend from dist/. One process, one port (3849).
Launch
Step 1: Check if already running
if curl -s http://localhost:3849/health > /dev/null 2>&1; then
echo "ALREADY_RUNNING"
else
echo "NOT_RUNNING"
fi
Step 2: Find the visualizer directory
VISUALIZER_DIR=""
for dir in \
"$HOME/.claudia/visualizer" \
"$(npm root -g 2>/dev/null)/get-claudia/visualizer"; do
if [ -d "$dir" ] && [ -f "$dir/server.js" ]; then
VISUALIZER_DIR="$dir"
break
fi
done
if [ -z "$VISUALIZER_DIR" ]; then
echo "VISUALIZER_NOT_FOUND"
else
echo "VISUALIZER_FOUND:$VISUALIZER_DIR"
fi
Step 3: Start the server (if NOT_RUNNING and VISUALIZER_FOUND)
PROJECT_DIR="$(pwd)"
cd "$VISUALIZER_DIR"
# Install deps if needed
if [ ! -d "node_modules" ]; then
echo "Installing dependencies..."
npm install --production 2>&1
fi
# Start server with --open to auto-launch browser
nohup node server.js --project-dir "$PROJECT_DIR" --open > /tmp/claudia-brain.log 2>&1 &
sleep 2
# Verify it started
if curl -s http://localhost:3849/health > /dev/null 2>&1; then
echo "STARTED"
else
echo "FAILED"
tail -10 /tmp/claudia-brain.log
fi
Step 4: Open browser (if ALREADY_RUNNING)
If the server was already running, just open the browser:
open "http://localhost:3849" 2>/dev/null || xdg-open "http://localhost:3849" 2>/dev/null || echo "OPEN_MANUALLY:http://localhost:3849"
Report to User
If already running:
Your brain is live at http://localhost:3849
If started successfully:
**Brain Visualizer**
Live at http://localhost:3849
Viewing database for: [PROJECT_DIR]
What you're seeing:
- **Entities** (people, orgs, projects, concepts) as colored nodes, size scales with importance
- **Relationships** as arcing edges with traveling pulse particles
- **Patterns** as wireframe clusters
- **Starfield** background, the galaxy is just ambiance
**Controls:**
- Click any node to see details, memories, and relationships
- Search bar (top left) to find specific entities, camera flies to matches
- H = toggle HUD, R = reset camera, F = fullscreen, Esc = close panel
- The graph updates live as I learn new things
If visualizer not found:
The Brain Visualizer isn't installed at ~/.claudia/visualizer/.
To install: run `npx get-claudia` again, or manually copy the visualizer directory:
1. Copy `visualizer/` from the get-claudia package to `~/.claudia/visualizer/`
2. Run `npm install --production` there
3. Try `/brain` again
If server failed to start:
The server couldn't start. Check the log:
```bash
tail -50 /tmp/claudia-brain.log
Common issues:
- Port 3849 already in use (kill the old process first)
- Database not found for this project (make sure --project-dir is correct)
- Missing node_modules (run
npm install --productionin ~/.claudia/visualizer/)
---
## Tone
Treat this like showing someone something cool. A little proud of it. "Want to see what your memory graph looks like?" energy.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
map-connections
Scan context files to extract entities and relationships into the memory system. Triggers on "who knows who?", "network graph", "map my connections", "extract relationships".
inbox-check
Lightweight inbox triage across all configured email accounts. Dispatches fast subagent to fetch, then reviews with judgment. Use when user says "check my inbox", "any new emails?", "check email".
growth-check
Periodic reflection on development, skills, learning, and progress toward goals. Triggers on "am I growing?", "development check", "personal growth review".
feedback
Send feedback, ideas, or bug reports about Claudia. Opens a pre-filled GitHub Discussion with system context. Use when user says "feedback", "suggestion", "report a bug", "feature request", or "I have an idea".
draft-reply
Draft an email response with tone matching the relationship context. Shows draft for approval before sending. Use when user says "draft a reply", "respond to this email", "write a response to [person]", or shares an email and asks for help replying.
new-person
Create a relationship tracking file for a person with contact info, history, and communication preferences. Use when user says "new person", "add [name]", "create a file for [name]", "track this person", or mentions someone important who doesn't have a file yet.
Didn't find tool you were looking for?