Skip to content

Memex

Zettelkasten-based persistent memory for AI coding agents. Works with Claude Code, Cursor, VS Code Copilot, Codex, Windsurf & any MCP client. No vector DB — just markdown + git…

Install

$git clone https://github.com/iamtouchskyer/memex

Install command taken from the project's README or registry entry. Always review code before running it.

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

Platform Integration Experience
Claude Code Plugin (hooks + skills) Best — auto-recall, slash commands, SessionStart hook
VS Code / Copilot MCP Server 12 MCP tools, zero config
Cursor MCP Server 12 MCP tools, zero config
Codex MCP Server 12 MCP tools, zero config
Windsurf MCP Server 12 MCP tools, zero config
Pi Extension (custom tools + hooks) 8 tools, auto-recall hook, slash commands
Any MCP client MCP Server 12 MCP tools, zero config

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
  • Pi: Requires Node.js 18+ and npm install -g @touchskyer/memex
  • All other platforms (Cursor, Codex, Windsurf, etc.): Requires Node.js 18+

Install

Step 1: Add memex to your editor

Platform Command
VS Code / Copilot Search "memex" in VS Code Extensions — install and done, no extra setup
Claude Code /plugin marketplace add iamtouchskyer/memex then /plugin install memex@memex
Claude Code (MCP fallback) npm install -g @touchskyer/memex && memex mcp-config --claude-code
Cursor First npm install -g @touchskyer/memex, then one-click install
Codex npm install -g @touchskyer/memex && codex mcp add memex -- memex mcp
Pi npm install -g @touchskyer/memex && pi install npm:@touchskyer/memex
Windsurf / others npm install -g @touchskyer/memex, then add MCP server: command memex, args ["mcp"]

Note: If you use Claude Code inside VS Code, follow the Claude Code row — not "VS Code / Copilot". The VS Code extension serves GitHub Copilot only; Claude Code has its own plugin system.

That's it — no extra setup needed. The MCP tool descriptions tell your agent when to recall and retro.

Upgrade

Platform How
VS Code / Copilot Extension auto-updates from marketplace
Claude Code /plugin uninstall memex then /plugin install memex@memex
Pi npm update -g @touchskyer/memex and re-copy pi-extension/index.ts
Cursor / Codex / Windsurf npm update -g @touchskyer/memex

Cross-platform sharing

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

Similar plugs

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

Java 面试 & 后端通用面试指南,覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发

Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype…

Explore related