From a27f50157a8a84ad44393b50a887253874d9f6ab Mon Sep 17 00:00:00 2001 From: Augustas Date: Thu, 13 Aug 2026 15:04:24 +0300 Subject: [PATCH 1/2] add Engram Claude Code plugin --- docs/engram/install-integrate.md | 20 +++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) diff --git a/docs/engram/install-integrate.md b/docs/engram/install-integrate.md index 0baa57110..3e167741f 100644 --- a/docs/engram/install-integrate.md +++ b/docs/engram/install-integrate.md @@ -1,6 +1,6 @@ --- title: Install & integrate -description: "Ways to use Engram: the Python SDK, the REST API, and agent integrations such as the Hermes memory plugin." +description: "Ways to use Engram: the Python SDK, the REST API, and agent integrations such as the Claude Code and Hermes memory plugins." image: og/docs/engram.png --- @@ -11,6 +11,7 @@ There are several ways to use Engram, from calling the API directly to dropping - **[Python SDK](#python-sdk)** — the `weaviate-engram` client for Python applications. - **[REST API](#rest-api)** — call Engram over HTTP from any language. +- **[Claude Code plugin](#claude-code-plugin)** — persistent, cross-session memory for Claude Code through the `engram` plugin. - **[Hermes Agent](#hermes-agent)** — long-term memory for the Hermes Agent through the `hermes-weaviate-engram` plugin. Every method authenticates with an [Engram API key](quickstart.md#step-2-create-an-api-key). @@ -63,6 +64,23 @@ curl -X POST "https://api.engram.weaviate.io/v1/memories" \ See the [REST API reference](/engram/api/rest) for the full list of endpoints, and the [guides](guides/store-memories.md) cover storing, searching, and managing memories. +## Claude Code plugin + +The [`engram` plugin](https://github.com/weaviate/engram-plugins) gives [Claude Code](https://claude.com/claude-code) long-term memory backed by Engram. It recalls relevant memories before each answer and stores each completed turn — everything happens automatically via hooks, with no tools for the agent to call. Memory is best-effort and never blocks a session. + +Set your API key in your shell (or a shell profile so it persists), then install the plugin inside a Claude Code session: + +```bash +export ENGRAM_API_KEY=... +``` + +```bash +/plugin marketplace add weaviate/engram-plugins +/plugin install engram@weaviate-engram +``` + +That's it — memory starts working on your next prompt. See the [plugin README](https://github.com/weaviate/engram-plugins) for more info and optional customization. + ## Hermes Agent [`hermes-weaviate-engram`](https://github.com/weaviate/hermes-weaviate-engram) is a memory provider plugin that gives the [Hermes Agent](https://github.com/NousResearch/hermes-agent) long-term memory backed by Engram. It recalls relevant memories into the system prompt before each turn, and stores each completed turn through Engram's pipeline. From 2e1d2a8a9e0123c1011d8b93b5755887c4a304a9 Mon Sep 17 00:00:00 2001 From: Augustas Date: Thu, 13 Aug 2026 15:47:48 +0300 Subject: [PATCH 2/2] improve setup description --- docs/engram/install-integrate.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/engram/install-integrate.md b/docs/engram/install-integrate.md index 3e167741f..4d00da0a2 100644 --- a/docs/engram/install-integrate.md +++ b/docs/engram/install-integrate.md @@ -68,7 +68,9 @@ See the [REST API reference](/engram/api/rest) for the full list of endpoints, a The [`engram` plugin](https://github.com/weaviate/engram-plugins) gives [Claude Code](https://claude.com/claude-code) long-term memory backed by Engram. It recalls relevant memories before each answer and stores each completed turn — everything happens automatically via hooks, with no tools for the agent to call. Memory is best-effort and never blocks a session. -Set your API key in your shell (or a shell profile so it persists), then install the plugin inside a Claude Code session: +When creating your Engram project, you choose [topics](concepts/topics.md) that control what memories get extracted. Select the **Coding Assistant** template for topics tailored to coding sessions — you can also define custom topics for a more tailored experience. + +Once the project is created, set your API key in your shell profile (e.g. `~/.zshrc` or `~/.bashrc`), then install the plugin inside a Claude Code session: ```bash export ENGRAM_API_KEY=...