An open protocol for personal AI memory - a living, evolving understanding of you that any AI service can query securely.
Organic Memory creates a persistent memory layer that learns about you through conversations. Instead of every AI interaction starting from scratch, your preferences, patterns, and personality are captured and made available to any service you authorize.
Organic Memory now tracks two complementary axes:
- Behavioral facets - worldview, business perspective, goals, affiliations, styles, tendencies, passions, pet peeves
- Memory dimensions - BUILD, EAT, MOVE, PLAY, THINK, CONNECT
The behavioral facets capture durable identity and taste. The dimensions capture where those signals show up in day-to-day life.
Your memory is also organized into six dimensions:
- BUILD - How you create (coding patterns, tool preferences, project approaches)
- EAT - Food and nutrition preferences
- MOVE - Exercise and fitness patterns
- PLAY - Leisure and entertainment choices
- THINK - Problem-solving approaches and mental models
- CONNECT - Communication style and relationship patterns
Each insight exists at three depth levels: surface (observations), pattern (recurring behaviors), and core (fundamental beliefs).
- Active Learning - Extracts insights from conversations automatically
- Crypto Identity - Ed25519 keypairs for secure, verified queries
- Query API - External services can ask questions about you
- Access Control - Grant/revoke access per service, per dimension
- Memory Evolution - Insights age and decay without reinforcement
- Import Sources - Bootstrap from GitHub, URLs, and other sources
- Interview Engine - Structured AI interviews that progressively build a behavioral profile
- Behavioral Profile API - Query worldview, goals, style, and content preferences for downstream agents
- Terminal UI - Retro terminal aesthetic with color-coded output
- Next.js 15 (App Router)
- TypeScript
- PostgreSQL + Drizzle ORM
- Vercel AI SDK + Anthropic
- Tailwind CSS
# Install dependencies
pnpm install
# Set up environment
cp .env.example .env
# Add your ANTHROPIC_API_KEY and database URL
# Push database schema
pnpm db:push
# Run development server
pnpm devmemory # Show overview of all dimensions
memory <dimension> # Show insights for BUILD, EAT, MOVE, etc.
memory export # Create encrypted JSON backup
memory grant # Manage access permissions
POST /api/interviewstarts a behavior-first interview sessionPATCH /api/interviewanswers the current question and advances the sessionGET /api/interview?sessionId=...fetches session state and the next promptGET /api/profilereturns a behavioral profile summaryGET /api/profile?view=contentreturns a content-oriented slice of worldview, goals, style, passions, and pet peevesPOST /api/memory/querysupports signed natural-language queries with optionaldimensions,facets, andcontextsfilters
A TypeScript SDK is included for integrating with Organic Memory:
import { OrganicMemoryClient } from './sdk'
const client = new OrganicMemoryClient({
endpoint: 'http://localhost:3000',
privateKey: yourPrivateKey
})
const insights = await client.query('how does this user prefer to structure code?')The Organic Memory Protocol (OMPv1) defines:
- Authentication flow with signed requests
- Query/response message formats
- Access control and permission grants
- Error codes and handling
See /docs for the full protocol specification.
MIT