Memory

The memory API manages knowledge chunks extracted from Claude Code sessions. Each chunk has a type, relevance score, and optional project association. For conceptual details, see Claude Memory System.

Endpoints

Search Memories

GET /api/memory/search

Search stored memory chunks by text query with optional filters. Matching memories have their access count incremented automatically.

Authentication: Required

Query Parameters:

Response: 200 OK

{
  "data": [
    {
      "id": "uuid",
      "sessionId": "session-abc",
      "projectPath": "/home/user/my-project",
      "chunkType": "decision",
      "content": "Use PostgreSQL for the database layer",
      "sourceExcerpt": "After evaluating SQLite and Postgres...",
      "relevanceScore": 0.95,
      "accessCount": 3,
      "lastAccessedAt": "2026-02-18T12:00:00.000Z",
      "createdAt": "2026-02-15T08:30:00.000Z"
    }
  ]
}

Get Context

GET /api/memory/context

Retrieve recent, high-relevance memories formatted for Claude context injection. Returns both raw memory objects and a pre-formatted text block grouped by type.

Authentication: Required

Query Parameters:

Response: 200 OK

{
  "data": {
    "memories": [{ "id": "uuid", "chunkType": "decision", "content": "..." }],
    "formatted": "5 memories loaded:\n\n### Decisions\n- Use PostgreSQL\n\n### Patterns\n- Always use pnpm\n"
  }
}

Store Memory

POST /api/memory/store

Store a single memory chunk. Broadcasts a resource_change notification on success.

Authentication: Required

Request Body:

Response: 201 Created

{
  "data": {
    "id": "uuid",
    "chunkType": "fact",
    "content": "The deploy target is a Hetzner VPS running Ubuntu 24.04",
    "relevanceScore": 1.0,
    "accessCount": 0,
    "createdAt": "2026-02-18T12:00:00.000Z"
  }
}

Extract Memories

POST /api/memory/extract

Extract and store memories from a conversation transcript using AI. Accepts either raw transcript text or a file path to a transcript.

Authentication: Required

Request Body:

Response: 200 OK

{
  "data": [
    { "id": "uuid", "chunkType": "decision", "content": "Use Drizzle ORM", "relevanceScore": 0.9 }
  ],
  "message": "Extracted 3 memories"
}

If no extractable memories are found:

{
  "data": [],
  "message": "No memories worth extracting"
}

Delete Memory

DELETE /api/memory/:id

Delete a single memory chunk by ID. Broadcasts a resource_change notification.

Authentication: Required

Path Parameters:

Response: 200 OK

{ "data": { "success": true } }

Errors:

Type Reference

Memory types are defined in shared/types/index.ts. See Database Schema for the full memory_chunks table definition.