
Claude Memory Extractor
https://github.com/obra/claude-memory-extractor- Category
- Developer Tools
- Rank
- No. 1602Tools index
Previous survey · No. 1580 ·
- Pricing
- Open Source
- Type
- TOOL
- Builder
- obra
- GitHub
- 118 stars
- Date
About
Extracts memories from Claude conversations for persistent context across sessions.
What it does
Claude Memory Extractor scans Claude Code JSONL conversation logs, divides long sessions into chunks, and asks an authenticated Claude CLI agent to identify transferable lessons. It writes each result as human-readable Markdown with structured metadata, confidence, triggers, and analysis of causes, motivations, and prevention strategies.
Why it's ranked here
The pipeline is concrete and inspectable, with local transcript parsing, bounded chunking, and plain Markdown output. Human validation reported strong agreement after prompt calibration. Still, the repository’s own warning says the work received limited human scrutiny, and extracted lessons require manual review.
What's good
It preserves source context, distinguishes problem-solving methods from narrow technical fixes, and records uncertainty instead of presenting every inference as certain. Users can select a starting date and custom input or output directories. Incremental runs remember the previous extraction time, while readable Markdown keeps results easy to inspect and edit.
Tradeoffs
It requires Node.js 18 or newer plus an installed, authenticated Claude CLI. Each conversation reportedly takes one to two minutes and costs roughly $0.50 to $2.00 in tokens. There is no search interface or automatic memory injection. The advertised dry run still performs extraction and merely limits processing to twenty sessions.
How to use it well
It suits Claude Code users willing to periodically mine debugging sessions, corrections, and working preferences, then manually curate the resulting Markdown. Start with a narrow time range and inspect several outputs before processing a larger archive. It does not provide retrieval, semantic search, automatic context injection, or a complete memory-management system.
Technical notes+
The npm package is defined in package.json and compiles TypeScript into a command-line executable. src/cli.ts exposes extract and info commands through Commander. src/commands/extract.ts coordinates parsing, chunking, extraction, incremental timestamp handling, and temporary-directory cleanup. src/extraction/parser.ts recursively reads JSONL transcripts and filters sessions by file modification time. src/extraction/chunker.ts targets 200,000-character chunks with a 280,000-character ceiling and simple correction and topic-shift heuristics. src/extraction/agent-extractor.ts writes prompts under /tmp, invokes the Claude CLI with Sonnet and Write-only tool access, and counts newly created Markdown files. The initial design document describes search, hooks, reinforcement, and vector indexing, but the supplied implementation covers extraction only.
Observed
- License
- MIT
- Primary language
- TypeScript on Node.js
- Install surface
- npm package with global installation and source-build instructions
- Interface
- Command-line interface with extract and info commands
- Runtime support
- Node.js 18 or newer
- External requirement
- Installed and authenticated Claude CLI
- Output format
- Markdown files with YAML frontmatter
- Runtime dependencies
- Commander and dotenv
Read from README.md, package.json, src/cli.ts, src/types/index.ts, src/types/memory.ts, src/types/session.ts, src/commands/extract.ts, src/extraction/parser.ts, src/extraction/chunker.ts, src/extraction/agent-extractor.ts, docs/README.md, docs/guides/quick-start.md, docs/guides/initial-design.md, docs/research/research-summary.md, docs/research/ground-truth-validation.md.
What it can do
Extract memories from Claude conversation history
Claude conversation logs or chat history → Structured memory data
Parse conversation context for key information
Raw conversation text → Identified important context and facts
Store extracted memories for future sessions
Processed memory data → Persistent memory storage
Retrieve stored memories for new conversations
User query or new conversation context → Relevant historical context and memories
Maintain context continuity across chat sessions
Previous conversation memories and current session → Enhanced conversation with historical context
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.