penfield

# Penfield Memory

Persistent memory that compounds. Your agent remembers conversations, learns preferences, connects ideas, and picks up exactly where it left off—across sessions, days, and channels.

## Tools

### Memory

| Tool | Purpose | When to use |
|------|---------|-------------|
| `penfield_store` | Save a memory | User shares preferences, you make a discovery, a decision is made, you learn something worth keeping |
| `penfield_recall` | Hybrid search (BM25 + vector + graph) | Need context before responding, resuming a topic, looking up prior decisions |
| `penfield_search` | Semantic search (higher vector weight) | Fuzzy concept search when you don't have exact terms |
| `penfield_fetch` | Get memory by ID | Following up on a specific memory from recall results |
| `penfield_update_memory` | Edit existing memory | Correcting, adding detail, changing importance or tags |

### Knowledge Graph

| Tool | Purpose | When to use |
|------|---------|-------------|
| `penfield_connect` | Link two memories | New info relates to existing knowledge, building understanding over time |
| `penfield_explore` | Traverse graph from a memory | Understanding how ideas connect, finding related context |

### Context & Analysis

| Tool | Purpose | When to use |
|------|---------|-------------|
| `penfield_save_context` | Checkpoint a session | Ending substantive work, preparing for handoff to another agent |
| `penfield_restore_context` | Resume from checkpoint | Picking up where you or another agent left off |
| `penfield_list_contexts` | List saved checkpoints | Finding previous sessions to resume |
| `penfield_reflect` | Analyze memory patterns | Session start orientation, finding themes, spotting gaps |

### Artifacts

| Tool | Purpose | When to use |
|------|---------|-------------|
| `penfield_save_artifact` | Store a file | Saving diagrams, notes, code, reference docs |
| `penfield_retrieve_artifact` | Get a file | Loading previously saved work |
| `penfield_list_artifa...