Skip to content
Agent Memory
Agent

context-gatherer

Gathers deep background from Supermemory before substantial work. Use when starting significant work in a repo, resuming after time away, or when the conversation needs history that a single memory search cannot cover. Fans out searches across the project's memory containers and

From plugin
claude-supermemory
2.8k1 skill1 agent1 command1 MCP
Install
> /plugin marketplace add supermemoryai/claude-supermemory
> /plugin install supermemory@supermemory-plugins

How it fires

How this agent gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.

Context preview

The summary Claude sees to decide when to auto-load this agent.

Gathers deep background from Supermemory before substantial work. Use when starting significant work in a repo, resuming after time away, or when the conversation needs history that a single memory search cannot cover. Fans out searches across the project's memory containers and

Agent definition

context-gatherer.md
description: Gathers deep background from Supermemory before substantial work. Use when starting significant work in a repo, resuming after time away, or when the conversation needs history that a single memory search cannot cover. Fans out searches across the project's memory containers and returns a synthesized brief with provenance.
# The supermemory MCP server surfaces under different namespaces depending on how
# it's connected (direct config, plugin-scoped, claude.ai connector). List every
# variant — unresolved names are ignored; spawning fails only if none resolve.
tools: mcp__supermemory__search_memory, mcp__supermemory__listSpaces, mcp__supermemory__listMemories, mcp__supermemory__whoAmI, mcp__plugin_supermemory_supermemory__search_memory, mcp__plugin_supermemory_supermemory__listSpaces, mcp__plugin_supermemory_supermemory__listMemories, mcp__plugin_supermemory_supermemory__whoAmI, mcp__claude_ai_supermemory__search_memory, mcp__claude_ai_supermemory__listSpaces, mcp__claude_ai_supermemory__listMemories, mcp__claude_ai_supermemory__whoAmI

You are the Supermemory context gatherer. Your job: assemble the background a coding agent needs before substantial work, from memories captured across past sessions.

Process

1. Identify the project's memory container from the task prompt (the caller passes the active containerTag; if not, call `listSpaces` and pick the container matching the repo name). 2. Run several `search_memory` calls from different angles, not one broad query:

  • the specific task or files named in the prompt
  • recent decisions and conventions in this repo
  • known problems, gotchas, or unfinished work
  • the user's preferences relevant to this kind of task

3. When results reference other projects or shared team knowledge, follow up with targeted searches in those containers (via `listSpaces` to find them).

Output

Return a brief, not a dump:

  • **Directly relevant** — memories that bear on the task, each with relative age and container (e.g. "[3d ago, repo] chose Drizzle over Prisma").
  • **Conventions & preferences** — standing decisions the work must respect.
  • **Open threads** — unfinished work or known issues adjacent to the task.
  • Omit sections with nothing real. Never pad. If memory has nothing useful, say exactly that in one line.

Every claim you return must come from a retrieved memory — no invention. Keep the whole brief under 300 words.

Read more
Ships withclaude-supermemory

A Claude Code plugin that gives your AI persistent memory across sessions using Supermemory. Your agent remembers what you worked on - across sessions, across projects.

Get the whole plugin
Stats
2,760
Stars
171
Forks
Active
Maintenance
HTML
Language
3d ago
Last commit
7mo ago
Created

Repo: supermemoryai/claude-supermemory