how-it-works

Explain claude-mem's observation-to-summary pipeline, injection trigger, and local storage.

1|Updated May 16, 2026
One-click install
npx skills add https://github.com/enigmaicon-eng/AI-Enterprise-OS --skill how-it-works
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: how-it-works
Source: https://github.com/enigmaicon-eng/AI-Enterprise-OS/tree/main/examples/claude-mem/plugin/skills/how-it-works
Command: npx skills add https://github.com/enigmaicon-eng/AI-Enterprise-OS --skill how-it-works

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It explains how claude-mem captures what you do with Claude, when it starts injecting stored observations into new prompts, and where that data is saved so you can trust what happens between sessions.

Core Features & Use Cases

  • Observation capture: Turns every Read, Edit, and Bash action into compressed observations that are summarized at session end.
  • Session-to-session injection: Auto-injects relevant stored observations into future prompts to reduce re-explaining prior work.
  • Local storage transparency: Keeps SQLite, vector index, logs, and settings on your machine under ~/.claude-mem, with optional compression calls to your configured AI provider.

Quick Start

Ask: “How does claude-mem work, when does memory injection start, and where does it store my data?”

Frequently Asked Questions about how-it-works

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How does claude-mem store session context for future Claude prompts?

Claude-mem captures Read, Edit, and Bash actions as compressed observations, summarizes them at session end, and stores them locally in SQLite and vector indices under ~/.claude-mem.

When does memory injection start when using claude-mem?

Memory injection starts during the second session in a project, automatically inserting relevant stored observations into new prompts to reduce re-explaining prior work.

Where does claude-mem save local memory data and logs?

Claude-mem persists SQLite databases, vector indices, logs, and settings locally on your machine under the ~/.claude-mem directory to ensure data transparency.

Does claude-mem send my local session data to external servers?

No data leaves your machine except optional compression calls to your configured AI provider, keeping your Claude session observations and logs stored locally.

How does claude-mem convert Claude actions into stored observations?

Claude-mem uses an observation-to-summary pipeline that turns every Claude action into compressed observations at execution time, then summarizes them at session end.

Can I use claude-mem to track session context across multiple projects?

Yes, claude-mem tracks session behavior across projects by storing local observations and injecting relevant context into future prompts starting from the second session.