memex

Persistent memory for AI coding agents. Your agent remembers what it learned across sessions.

English | 中文 | 日本語 | 한국어 | Español

English

Every time your AI agent finishes a task, it saves insights as atomic knowledge cards with [[bidirectional links]]. Next session, it recalls relevant cards before starting work — building on what it already knows instead of starting from scratch.

No vector database, no embeddings — just markdown files your agent (and you) can read.

Supported platforms

All platforms share the same ~/.memex/cards/ directory. A card written in Claude Code is instantly available in Cursor, Codex, or any other client.

Prerequisites

• VS Code / Copilot: No prerequisites — the extension bundles everything
• Claude Code: No prerequisites — the plugin handles everything
• All other platforms (Cursor, Codex, Windsurf, etc.): Requires Node.js 18+

Install

Step 1: Add memex to your editor

Step 2: Set up your project (Cursor, Copilot, Codex, Windsurf only — Claude Code users skip this)

memex init

This adds a memex section to AGENTS.md that teaches your agent when to recall and retro. Without this, your agent won't know memex exists.

Upgrade

Cross-platform sharing

All clients read and write the same ~/.memex/cards/ directory. Sync across devices with git:

memex sync --init git@github.com:you/memex-cards.git
memex sync on      # enable auto-sync after every write
memex sync         # manual sync
memex sync off     # disable auto-sync

Browse your memory

memex serve

Opens a visual timeline of all your cards at localhost:3939. Includes a graph view to explore bidirectional links:

CLI reference

memex search [query]          # search cards, or list all
memex read <slug>             # read a card
memex write <slug>            # write a card (stdin)
memex links [slug]            # link graph stats
memex archive <slug>          # archive a card
memex serve                   # visual timeline UI
memex sync                    # sync via git
memex mcp                     # start MCP server (stdio)
memex init                    # add memex section to AGENTS.md

How it works

Based on Niklas Luhmann's Zettelkasten method — the system behind 70 books from 90,000 handwritten cards:

• Atomic notes — one idea per card
• Own words — forces understanding (the Feynman method)
• Links in context — "this relates to [[X]] because..." not just tags
• Keyword index — curated entry points to the card network

Cards are stored as markdown in ~/.memex/cards/. Open them in Obsidian, edit with vim, grep from terminal. Your memory is never locked in.

中文

AI 编程 agent 的持久记忆系统。让你的 agent 跨会话记住学到的知识。

每次 agent 完成任务后，它会将洞察保存为带有 [[双向链接]] 的原子知识卡片。下次会话时，agent 会先回顾相关卡片再开始工作——基于已有知识继续，而非从零开始。

无需向量数据库，无需 embedding——只是你和 agent 都能读取的 markdown 文件。

支持平台

所有平台共享同一个 ~/.memex/cards/ 目录。在 Claude Code 中写的卡片，在 Cursor、Codex 或其他客户端中即刻可用。

前置要求

• VS Code / Copilot：无需额外安装——扩展内置了所有依赖
• Claude Code：无需额外安装——plugin 自动处理
• 其他平台（Cursor、Codex、Windsurf 等）：需要 Node.js 18+

安装

第一步：添加 memex 到编辑器

第二步：配置项目（仅 Cursor、Copilot、Codex、Windsurf 需要——Claude Code 用户跳过此步）

memex init

这会在 AGENTS.md 中添加 memex 指令，教 agent 何时 recall 和 retro。不执行此步，agent 不会知道 memex 的存在。

日本語

AIコーディングエージェントのための永続メモリシステム。エージェントがセッションをまたいで学んだことを記憶します。

エージェントがタスクを完了するたびに、[[双方向リンク]]付きのアトミックな知識カードとしてインサイトを保存します。次のセッションでは、作業開始前に関連カードを呼び出し、ゼロからではなく既存の知識の上に構築します。

ベクトルデータベースもembeddingも不要——エージェント（とあなた）が読めるmarkdownファイルだけです。

対応プラットフォーム

すべてのプラットフォームが同じ ~/.memex/cards/ ディレクトリを共有します。Claude Codeで書いたカードは、Cursor、Codex、その他のクライアントですぐに利用できます。

前提条件

• VS Code / Copilot：前提条件なし——拡張機能がすべてをバンドル
• Claude Code：前提条件なし——プラグインがすべてを処理
• その他のプラットフォーム（Cursor、Codex、Windsurf等）：Node.js 18+ が必要

インストール

ステップ1：エディタにmemexを追加

ステップ2：プロジェクトを設定（Cursor、Copilot、Codex、Windsurfのみ——Claude Codeユーザーはスキップ）

memex init

AGENTS.md にmemexセクションを追加し、エージェントにリコールとレトロのタイミングを教えます。これがないと、エージェントはmemexの存在を知りません。

アップグレード

한국어

AI 코딩 에이전트를 위한 영구 메모리 시스템. 에이전트가 세션을 넘어 학습한 내용을 기억합니다.

에이전트가 작업을 완료할 때마다 [[양방향 링크]]가 포함된 원자적 지식 카드로 인사이트를 저장합니다. 다음 세션에서는 작업 시작 전에 관련 카드를 불러와, 처음부터가 아닌 기존 지식 위에 구축합니다.

벡터 데이터베이스도 임베딩도 필요 없습니다 — 에이전트(와 당신)가 읽을 수 있는 markdown 파일뿐입니다.

지원 플랫폼

모든 플랫폼이 동일한 ~/.memex/cards/ 디렉토리를 공유합니다. Claude Code에서 작성한 카드를 Cursor, Codex 또는 다른 클라이언트에서 즉시 사용할 수 있습니다.

전제 조건

• VS Code / Copilot: 전제 조건 없음 — 확장 프로그램에 모든 것이 포함
• Claude Code: 전제 조건 없음 — 플러그인이 모든 것을 처리
• 기타 플랫폼 (Cursor, Codex, Windsurf 등): Node.js 18+ 필요

설치

1단계: 에디터에 memex 추가

2단계: 프로젝트 설정 (Cursor, Copilot, Codex, Windsurf만 — Claude Code 사용자는 건너뛰기)

memex init

AGENTS.md에 memex 섹션을 추가하여 에이전트에게 리콜과 레트로 시점을 알려줍니다. 이것이 없으면 에이전트는 memex의 존재를 알지 못합니다.

업그레이드

Español

Memoria persistente para agentes de programación con IA. Tu agente recuerda lo que aprendió entre sesiones.

Cada vez que tu agente de IA termina una tarea, guarda conocimientos como tarjetas atómicas con [[enlaces bidireccionales]]. En la siguiente sesión, recupera las tarjetas relevantes antes de comenzar, construyendo sobre lo que ya sabe en lugar de empezar desde cero.

Sin base de datos vectorial, sin embeddings — solo archivos markdown que tu agente (y tú) pueden leer.

Plataformas compatibles

Todas las plataformas comparten el mismo directorio ~/.memex/cards/. Una tarjeta escrita en Claude Code está disponible instantáneamente en Cursor, Codex o cualquier otro cliente.

Requisitos previos

• VS Code / Copilot: Sin requisitos previos — la extensión incluye todo
• Claude Code: Sin requisitos previos — el plugin se encarga de todo
• Otras plataformas (Cursor, Codex, Windsurf, etc.): Requiere Node.js 18+

Instalación

Paso 1: Agrega memex a tu editor

Paso 2: Configura tu proyecto (solo Cursor, Copilot, Codex, Windsurf — usuarios de Claude Code salten este paso)

memex init

Agrega una sección memex a AGENTS.md que enseña a tu agente cuándo hacer recall y retro. Sin esto, tu agente no sabrá que memex existe.

Actualización

License

MIT