이게 불편했어요

새 세션을 열 때마다 어제 어떤 파일을 고쳤는지, 그 버그를 왜 그렇게 고쳤는지 처음부터 다시 설명해야 했어요. 세션이 끝나거나 다시 연결되면 그 맥락은 에이전트에게 남지 않아요.

그래서 이렇게 풀어요

claude-mem은 에이전트가 도구를 쓸 때마다 훅으로 그 기록을 받아 짧은 관찰로 압축해 쌓아 두고, 다음 세션이 시작되면 그중 필요한 것을 먼저 넣어 줘요. 더 깊이 찾아야 할 때는 에이전트가 search로 ID 목록을 보고, timeline으로 앞뒤 흐름을 본 뒤, get_observations로 고른 것만 자세히 꺼내요. README는 이렇게 걸러 읽어서 토큰을 10배쯤 아낀다고 설명해요.

안에서는 이렇게 돌아가요

1. 1

   Claude Code → claude-mem hook

   PostToolUse → claude-mem hook claude-code observation도구를 한 번 쓸 때마다 Claude Code가 플러그인에 등록된 훅을 불러요.plugin/hooks/hooks.json
2. 2

   claude-mem hook → Worker Service

   도구 사용 기록을 워커로훅이 도구 이름과 입력·출력을 로컬 워커에 넘기고, 서브에이전트 기록은 여기서 걸러요.src/cli/handlers/observation.ts
3. 3

   Worker Service → 관찰 모델

   관찰로 압축해 달라는 요청워커가 모아 둔 기록을 관찰 모델에 보내 제목·종류가 붙은 짧은 관찰로 줄여요.src/services/worker/ClaudeProvider.ts
4. 4

   관찰 모델 → SQLite + Chroma

   observation 저장돌아온 관찰을 SQLite에 넣고, 의미 검색을 위해 Chroma에도 써요.src/services/worker/agents/ResponseProcessor.ts
5. 5

   SQLite + Chroma → claude-mem hook

   SessionStart에 맥락 조립새 세션이 열리면 정해진 토큰 안에서 넣을 관찰을 골라 묶어요.src/services/context/ContextBuilder.ts
6. 6

   claude-mem hook → 다음 세션의 맥락

   additionalContext로 주입묶은 맥락을 SessionStart 훅의 답으로 돌려줘, 모델이 첫 대화 전에 읽게 해요.src/cli/handlers/context.ts

나한테 맞을까요

What was hard

Every new session meant explaining again which files you changed yesterday and why that bug was fixed the way it was. Once a session ends or reconnects, none of that stays with the agent.

What it does about it

claude-mem catches each tool call through a hook, compresses it into a short observation and keeps it, then hands the relevant ones to the next session before you type. When the agent needs more, it searches for a list of IDs, looks at the timeline around them, and fetches only the ones it picked with get_observations. The README puts the saving from that filtering at about 10x in tokens.

How it runs inside

1. 1

   Claude Code → claude-mem hook

   PostToolUse → claude-mem hook claude-code observationEvery time a tool runs, Claude Code calls the hook the plugin registered.plugin/hooks/hooks.json
2. 2

   claude-mem hook → Worker Service

   The tool call goes to the workerThe hook hands the tool name, input and output to the local worker, dropping subagent records here.src/cli/handlers/observation.ts
3. 3

   Worker Service → Observer model

   A request to compress itThe worker sends the batch to the observer model, which turns it into short observations with a title and type.src/services/worker/ClaudeProvider.ts
4. 4

   Observer model → SQLite + Chroma

   Observations storedThe observations go into SQLite and into Chroma for semantic search.src/services/worker/agents/ResponseProcessor.ts
5. 5

   SQLite + Chroma → claude-mem hook

   Context built at SessionStartWhen a new session opens, it picks the observations that fit a token budget.src/services/context/ContextBuilder.ts
6. 6

   claude-mem hook → Next session's context

   Injected as additionalContextThe bundle is the SessionStart hook's answer, so the model reads it before the first message.src/cli/handlers/context.ts

Is it for you