session-memory.mdā¢1.73 kB
# Cross-Session Memory
## Purpose
Maintain context and learnings across Claude Code sessions for continuous improvement.
## Memory Features
### 1. Automatic State Persistence
At session end, automatically saves:
- Active agents and specializations
- Task history and patterns
- Performance metrics
- Neural network weights
- Knowledge base updates
### 2. Session Restoration
```javascript
// Using MCP tools for memory operations
mcp__claude-flow__memory_usage({
"action": "retrieve",
"key": "session-state",
"namespace": "sessions"
})
// Restore swarm state
mcp__claude-flow__context_restore({
"snapshotId": "sess-123"
})
```
**Fallback with npx:**
```bash
npx claude-flow hook session-restore --session-id "sess-123"
```
### 3. Memory Types
**Project Memory:**
- File relationships
- Common edit patterns
- Testing approaches
- Build configurations
**Agent Memory:**
- Specialization levels
- Task success rates
- Optimization strategies
- Error patterns
**Performance Memory:**
- Bottleneck history
- Optimization results
- Token usage patterns
- Efficiency trends
### 4. Privacy & Control
```javascript
// List memory contents
mcp__claude-flow__memory_usage({
"action": "list",
"namespace": "sessions"
})
// Delete specific memory
mcp__claude-flow__memory_usage({
"action": "delete",
"key": "session-123",
"namespace": "sessions"
})
// Backup memory
mcp__claude-flow__memory_backup({
"path": "./backups/memory-backup.json"
})
```
**Manual control:**
```bash
# View stored memory
ls .claude-flow/memory/
# Disable memory
export CLAUDE_FLOW_MEMORY_PERSIST=false
```
## Benefits
- š§ Contextual awareness
- š Cumulative learning
- ā” Faster task completion
- šÆ Personalized optimization