Supermemory

Install the Supermemory provider for eve:

eve add memory/supermemory

This installs @supermemory/eve and writes a memory slot. The provider requires Node.js 24 or later and eve 0.47.3 or later.

Create a Supermemory API key and add it to the agent's environment:

SUPERMEMORY_API_KEY=...

The registry creates this memory slot:

import supermemory from "@supermemory/eve";import { defineMemory } from "eve/memory";import { byPrincipal } from "eve/memory/scope";
export default defineMemory({  description: "Recall and manage durable context for the current user.",  provider: supermemory({    apiKey: process.env.SUPERMEMORY_API_KEY!,  }),  scope: byPrincipal,});

The filename creates the supermemory memory slot, so the provider's tools are named supermemory__search, supermemory__remember, and supermemory__forget. The provider uses eve's locked scope key to partition all reads and writes.

byPrincipal keeps memory disabled for anonymous and runtime principals, and shares the local-development scope while you run eve dev. For a multi-tenant agent, replace it with a scope resolver that derives both tenant and caller identity from verified session context. See Multi-tenant memory.

Supermemory automatically recalls relevant context before a turn and captures completed turns. It also provides tools to search, read sessions and documents, remember context, extract files, URLs, or text, and forget memories. The provider sends stored conversations and extracted sources to Supermemory; configure its retention and data handling for your application before enabling it for sensitive data.

Keep SUPERMEMORY_API_KEY in the environment rather than prompts or source control. You can change the container-tag prefix, automatic search, capture policy, and profile-context time zone through supermemory(...). See the Supermemory eve provider documentation for all options and tool behavior.