ClaudeCodeMod

All shelves / Mods / Workflow

cognee-memory

By topoteretes

cognee-memory is a Claude Code workflow mod by topoteretes.

Draws a memory status row above the prompt, with a dataset picker, and recalls saved context each turn.

Draws

Install

The marketplace name is cognee.

In your shell
claude plugin marketplace add topoteretes/cognee-integrations
claude plugin install cognee-memory@cognee
Open the repo

It runs inside the Claude Code process. The side panel is only what the author's README names. Read the repo before you install, or run claude plugin validate on the plugin folder.

Version
1.7.1
License
Apache-2.0
Repo stars
101
Last change
2026-10-16

What it can reach

  • Draws in the session
  • Reads usage or context figures
  • Reaches the network or an outside service
  • Sees tool calls
  • Runs a command when you press
  • Calls another program on this machine

Python 3.9 or newer on PATH runs the hooks. Local mode also needs Python 3.10 through 3.14 already installed; the plugin does not download an interpreter. The live status row, spinner text, and the two memory tools need Claude Code 2.1.287 or newer, or 2.1.286 in the Desktop app. Install from the shell before you launch Claude Code. If you installed inside the chat, restart: /reload-plugins does not run session start. The author says it captures your prompts, the tool calls Claude makes (name, arguments, and output), Claude's answers, and a short memory anchor before compaction. Credentials, private keys, and database URLs are redacted, and .env, credential, and key files are never captured. COGNEE_CAPTURE=false turns automatic capture off. Local mode keeps memory on this machine and sends the captured text to the LLM and embedding provider you configured, or to Claude through an observer on your own login, which counts against your subscription. COGNEE_LLM_OBSERVER=false turns that observer off. Cloud mode sends the captured text to your Cognee instance at COGNEE_BASE_URL. The status line's credit balance comes from the Cognee platform API. Local mode installs cognee from PyPI once. An idle watcher fetches this repository's marketplace.json at most hourly. COGNEE_UPDATE_CHECK=off turns that off. The author says there is no telemetry and no analytics beyond those calls. In cloud mode it disables Claude Code's native auto-memory unless you set COGNEE_DISABLE_AUTO_MEMORY=false. When the hooks module does not load, session start writes a statusLine entry in ~/.claude/settings.json that runs the plugin's own status script, and it never replaces a status line you set. Picking a dataset runs switch-dataset.py. The fix dialog runs cognee-doctor.sh when you ask it to.

The marketplace name is cognee. Add topoteretes/cognee-integrations.

Demo

The cognee-memory section on the author's GitHub page
Screenshot of the author's GitHub page.

What it hooks into

  • session.startWhen a session starts
  • command.runWhen you run its slash command/cognee-tour/cognee-dataset
  • tool.callAround a tool call, where it can hold onemcp__cognee-memory__searchmcp__cognee-memory__remember
  • prompt.submitWhen you send a prompt
  • session.compactWhen the context is compacted
  • session.endWhen a session ends
  • turn.completeWhen a turn ends
  • ui.closeWhen its pane closes
  • ui.renderDraws into the sessionPaneAbovePromptAssistantMessageToolUseSpinner

Read from the on() calls in its hook modules. Open its source under Files to check what each one does.

Slash commands 2

  • /cognee-datasetSwitch this session to another Cognee dataset; without a name, list them.
  • /cognee-tourReplay the short tour of the Cognee status row.

Hooks 10

  • SessionStartpython3 "${CLAUDE_PLUGIN_ROOT}/scripts/hook_runner.py" "${CLAUDE_PLUGIN_ROOT}/scripts/session-start.py" || python "${CLAUDE_PLUGIN_ROOT}/scripts/hook_runner.py" "${CLAUDE_PLUGIN_ROOT}/scripts/session-start.py"
  • UserPromptSubmitpython3 "${CLAUDE_PLUGIN_ROOT}/scripts/hook_runner.py" "${CLAUDE_PLUGIN_ROOT}/scripts/session-context-lookup.py" || python "${CLAUDE_PLUGIN_ROOT}/scripts/hook_runner.py" "${CLAUDE_PLUGIN_ROOT}/scripts/session-context-lookup.py"
  • UserPromptSubmitpython3 "${CLAUDE_PLUGIN_ROOT}/scripts/hook_runner.py" "${CLAUDE_PLUGIN_ROOT}/scripts/store-user-prompt.py" || python "${CLAUDE_PLUGIN_ROOT}/scripts/hook_runner.py" "${CLAUDE_PLUGIN_ROOT}/scripts/store-user-prompt.py"
  • PreToolUse · Readpython3 "${CLAUDE_PLUGIN_ROOT}/scripts/hook_runner.py" "${CLAUDE_PLUGIN_ROOT}/scripts/file-context.py" || python "${CLAUDE_PLUGIN_ROOT}/scripts/hook_runner.py" "${CLAUDE_PLUGIN_ROOT}/scripts/file-context.py"
  • PostToolUse · Bash|Agent|Read|Write|Edit|Grep|Globpython3 "${CLAUDE_PLUGIN_ROOT}/scripts/hook_runner.py" "${CLAUDE_PLUGIN_ROOT}/scripts/store-to-session.py" || python "${CLAUDE_PLUGIN_ROOT}/scripts/hook_runner.py" "${CLAUDE_PLUGIN_ROOT}/scripts/store-to-session.py"
  • Stoppython3 "${CLAUDE_PLUGIN_ROOT}/scripts/hook_runner.py" "${CLAUDE_PLUGIN_ROOT}/scripts/store-to-session.py" --stop || python "${CLAUDE_PLUGIN_ROOT}/scripts/hook_runner.py" "${CLAUDE_PLUGIN_ROOT}/scripts/store-to-session.py" --stop
  • Stoppython3 "${CLAUDE_PLUGIN_ROOT}/scripts/hook_runner.py" "${CLAUDE_PLUGIN_ROOT}/scripts/credits-refresh.py" || python "${CLAUDE_PLUGIN_ROOT}/scripts/hook_runner.py" "${CLAUDE_PLUGIN_ROOT}/scripts/credits-refresh.py"
  • StopFailurepython3 "${CLAUDE_PLUGIN_ROOT}/scripts/hook_runner.py" "${CLAUDE_PLUGIN_ROOT}/scripts/credits-refresh.py" || python "${CLAUDE_PLUGIN_ROOT}/scripts/hook_runner.py" "${CLAUDE_PLUGIN_ROOT}/scripts/credits-refresh.py"
  • PreCompactpython3 "${CLAUDE_PLUGIN_ROOT}/scripts/hook_runner.py" "${CLAUDE_PLUGIN_ROOT}/scripts/pre-compact.py" || python "${CLAUDE_PLUGIN_ROOT}/scripts/hook_runner.py" "${CLAUDE_PLUGIN_ROOT}/scripts/pre-compact.py"
  • SessionEndpython3 "${CLAUDE_PLUGIN_ROOT}/scripts/hook_runner.py" "${CLAUDE_PLUGIN_ROOT}/scripts/sync-session-to-graph.py" --session-end || python "${CLAUDE_PLUGIN_ROOT}/scripts/hook_runner.py" "${CLAUDE_PLUGIN_ROOT}/scripts/sync-session-to-graph.py" --session-end

Files

The author's README and source, 4 files. They load when you open them.

Facts

Author
topoteretes
Category
Workflow
Marketplace
cognee
Repo
topoteretes/cognee-integrations
Folder
integrations/claude-code
Version
1.7.1
License
Apache-2.0
Repo stars
101
Last change
2026-10-16
Language
Python
Files
204

Other mods in Workflow

All 396 in Workflow