Concepts

Core Concepts

Understand the pieces behind Origin: memories, sessions, handoffs, pages, the daemon, MCP, Markdown, and the local index.

Origin teamUpdated May 15, 20266 min read

At a glance

01

Origin is local-first memory for AI work, not a chat UI or a notes app replacement.

02

Markdown stays human-readable while the local database keeps retrieval indexes, graph structure, and metadata.

01

Memory

A memory is one durable idea from your AI work. It might be a decision, preference, lesson, gotcha, project fact, or correction.

Good memories include enough context to be useful later, especially why the fact matters.

02

Session

A session is a period of work with an AI agent. The session itself is noisy, but it contains decisions, constraints, and lessons worth carrying forward.

Origin does not preserve every token as the primary interface. It extracts the durable parts and makes them searchable later.

03

Handoff

A handoff is the compact end-of-session record that lets a future agent resume without starting cold.

It usually includes what changed, what was decided, what remains open, and what the next agent should know before acting.

04

Distilled pages

Distilled pages are wiki-style Markdown artifacts synthesized from related memories. They make accumulated context easier to inspect than a long list of individual captures.

Pages are useful when a project, workflow, or concept keeps coming back across many sessions.

05

Daemon and MCP

The local daemon is the source of truth. It owns the database, search, distill cycles, provenance, and API.

The MCP server is the bridge. Claude Code, Codex, Cursor, Claude Desktop, Gemini CLI, and other MCP clients can connect to the same local memory layer.

06

Markdown plus local index

Origin keeps human-readable artifacts in Markdown while the local database keeps indexes, metadata, graph structure, and retrieval state.

That split matters for trust. The database helps agents search quickly, but the record is something you can inspect and control.

07

No model required

Origin gives you storage, embeddings, dedupe, hybrid search, and MCP recall without requiring a local model or API key.

Claude Code skills can still classify captures, write handoffs, and distill pages because the agent already has language intelligence in the session.

Next

Commands and Tools

The essential Claude Code commands and MCP tools for running Origin day to day.

Read next