Memory

Memory Events

Store conversations, decisions, and context that persists across sessions. Memory events are the core building blocks of ContextStream.

What are Memory Events?

Memory events capture moments of significance: decisions made, conversations had, code reviewed, or any context you want your AI tools to remember later.

Decisions

Architecture choices, tech stack decisions, trade-offs

Conversations

Meeting notes, discussions, feedback

Context

Project context, requirements, specifications

Timeline

Project milestones, events, changes

Creating Memory Events

Create a memory event via the REST API:

curl -X POST https://api.contextstream.io/api/v1/memory/events \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "your-workspace-id",
    "event_type": "decision",
    "title": "Chose React for the frontend",
    "content": "After evaluating React, Vue, and Svelte, we decided on React because of team familiarity and the extensive ecosystem.",
    "tags": ["frontend", "architecture", "react"],
    "metadata": {
      "alternatives_considered": ["vue", "svelte"],
      "confidence": "high"
    }
  }'

Event Types

decisionArchitectural or design decisions with rationale

conversationMeeting notes, discussions, Q&A sessions

observationInsights, learnings, discoveries

taskCompleted work, implementations, fixes

contextBackground information, requirements, specs

feedbackUser feedback, reviews, suggestions

Retrieving Memories

List recent memory events in a workspace:

curl https://api.contextstream.io/api/v1/memory/events?workspace_id=your-workspace-id \
  -H "Authorization: Bearer YOUR_API_KEY"

Or search semantically:

curl -X POST https://api.contextstream.io/api/v1/search/semantic \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "query": "frontend framework decisions",
    "search_type": "semantic",
    "workspace_id": "your-workspace-id"
  }'