Getting started

Origin runs on your machine. It reads the session logs your AI agents already write to disk, archives them in ~/.origin, and serves them to every agent through one MCP server. If you use agents on several machines, a self-hosted personal hub can bring them together later.

Early development

Origin is not yet published to npm. Install it from source as shown below.

Requirements

• Node.js 22.13 or later (24 LTS recommended)
• pnpm (corepack enable installs the version pinned by the repository)
• At least one supported agent: Claude Code or Codex CLI. Cursor, ZCode, and Grok Build can already use Origin; archiving their own sessions is coming next.

Install

git clone https://github.com/openlinkos/origin.git
cd origin
pnpm install
pnpm build

The origin command is node packages/cli/dist/bin.js. From the repository you can also run pnpm origin <command>, or alias the full path as origin.

Archive your sessions

origin sync      # ingest local agent sessions into ~/.origin
origin status    # sessions, events, and entries per source
origin timeline  # sessions from the last 7 days

sync is incremental and safe to re-run. When agents use Origin over MCP, the server syncs on its own, so you rarely need to run sync by hand.

Connect an agent

Register Origin once, at user scope, so that every project shares the same memory. For Claude Code:

claude mcp add --scope user origin -- node /path/to/origin/packages/cli/dist/bin.js mcp
claude mcp list   # origin: … ✔ Connected

Other agents are covered in Connect your agents.

Ask

Start a new session and ask about your past work, for example:

What did I decide about schema migrations in the origin project last week, and why? Cite your sources.

The agent searches Origin and answers with entry and event ids. To read the original, run origin show <id>. When the agent learns something worth keeping (a decision and its reason, a stable fact, or one of your preferences), it saves an entry with remember.

Curate your memory

origin entries                           # what agents have remembered
origin show ent_5f0c2a9e41b7             # an entry with its sources and history
origin correct ent_5f0c2a9e41b7 "…"      # replace it with a corrected version
origin forget ent_5f0c2a9e41b7 --yes     # forget it for good

See the CLI reference for every command, and Privacy and your data for what Origin stores and how forgetting works.