episodic-memory

v1.4.2

Semantic search for Claude Code and Codex conversations. Remember past discussions, decisions, and patterns.

CodexClaude Code1 skill1 MCP serverstdio

by Jesse VincentMIT463updated 2 months ago

Source

$ git clone https://github.com/obra/episodic-memory

Clone the source, then follow the repository's marketplace instructions for your runtime. The repository root is the plugin root.

Layout

episodic-memory/

├── .codex-plugin/plugin.json
├── .claude-plugin/plugin.json
├── skills/remembering-conversations/SKILL.md
└── .mcp.json

Skills1

remembering-conversationsskills/remembering-conversations/SKILL.md

You MUST invoke this skill before saying "I don't know," guessing, or treating any topic as new, no matter how trivial the question seems. It supplements other memory systems, which only hold partial records. Searching past conversations is the only way to recover what was actually said.

MCP servers1

episodic-memorystdio

command: node
args: ./cli/mcp-server-wrapper.js
cwd: .

Manifests2

.codex-plugin/plugin.json

{
  "name": "episodic-memory",
  "version": "1.4.2",
  "description": "Semantic search for Claude Code and Codex conversations. Remember past discussions, decisions, and patterns.",
  "author": {
    "name": "Jesse Vincent",
    "email": "jesse@fsck.com"
  },
  "homepage": "https://github.com/obra/episodic-memory",
  "repository": "https://github.com/obra/episodic-memory",
  "license": "MIT",
  "keywords": [
    "memory",
    "search",
    "conversations",
    "semantic-search",
    "episodic"
  ],
  "skills": "./skills/",
  "hooks": "./hooks/hooks.json",
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "Episodic Memory",
    "shortDescription": "Cross-harness conversation memory for Claude Code and Codex",
    "longDescription": "Episodic Memory indexes coding-agent conversations and exposes semantic recall across Claude Code and Codex sessions.",
    "developerName": "Jesse Vincent",
    "category": "Developer Tools",
    "capabilities": [
      "Interactive",
      "Read"
    ],
    "websiteURL": "https://github.com/obra/episodic-memory",
    "privacyPolicyURL": "https://github.com/obra/episodic-memory",
    "brandColor": "#4F46E5",
    "screenshots": []
  }
}

.claude-plugin/plugin.json

{
  "name": "episodic-memory",
  "version": "1.4.2",
  "description": "Semantic search for Claude Code conversations. Remember past discussions, decisions, and patterns.",
  "author": {
    "name": "Jesse Vincent",
    "email": "jesse@fsck.com"
  },
  "homepage": "https://github.com/obra/episodic-memory",
  "repository": "https://github.com/obra/episodic-memory",
  "license": "MIT",
  "keywords": [
    "memory",
    "search",
    "conversations",
    "semantic-search",
    "episodic"
  ],
  "agents": [
    "./agents/search-conversations.md"
  ],
  "mcpServers": {
    "episodic-memory": {
      "command": "node",
      "args": [
        "${CLAUDE_PLUGIN_ROOT}/cli/mcp-server-wrapper.js"
      ],
      "env": {}
    }
  }
}