diff --git a/apps/docs/docs.json b/apps/docs/docs.json index 75d91754..b8d16003 100644 --- a/apps/docs/docs.json +++ b/apps/docs/docs.json @@ -233,6 +233,7 @@ "pages": [ "integrations/supermemory-sdk", "integrations/ai-sdk", + "integrations/eve", "integrations/openai", "integrations/langgraph", "integrations/openai-agents-sdk", @@ -387,12 +388,12 @@ "icon": "puzzle", "pages": [ "integrations/openclaw", + "integrations/hermes", "integrations/claude-code", - "integrations/cursor", - "integrations/grok-bot", - "integrations/opencode", "integrations/codex", - "integrations/hermes" + "integrations/opencode", + "integrations/cursor", + "integrations/grok-bot" ] } ] diff --git a/apps/docs/images/codex.svg b/apps/docs/images/codex.svg new file mode 100644 index 00000000..7844c76f --- /dev/null +++ b/apps/docs/images/codex.svg @@ -0,0 +1,27 @@ + +Codex diff --git a/apps/docs/images/eve-memory-poster.png b/apps/docs/images/eve-memory-poster.png new file mode 100644 index 00000000..1d766a63 Binary files /dev/null and b/apps/docs/images/eve-memory-poster.png differ diff --git a/apps/docs/images/eve.svg b/apps/docs/images/eve.svg new file mode 100644 index 00000000..a38995b4 --- /dev/null +++ b/apps/docs/images/eve.svg @@ -0,0 +1,6 @@ + + +Eve + + + diff --git a/apps/docs/images/opencode-logo-dark.svg b/apps/docs/images/opencode-logo-dark.svg new file mode 100644 index 00000000..6a67f627 --- /dev/null +++ b/apps/docs/images/opencode-logo-dark.svg @@ -0,0 +1,18 @@ + + + + + + + + + + + + + + + + + + diff --git a/apps/docs/images/opencode-logo.svg b/apps/docs/images/opencode-logo.svg new file mode 100644 index 00000000..a738ad87 --- /dev/null +++ b/apps/docs/images/opencode-logo.svg @@ -0,0 +1,18 @@ + + + + + + + + + + + + + + + + + + diff --git a/apps/docs/integrations/codex.mdx b/apps/docs/integrations/codex.mdx index 17978460..cf756e2b 100644 --- a/apps/docs/integrations/codex.mdx +++ b/apps/docs/integrations/codex.mdx @@ -1,8 +1,8 @@ --- -title: "OpenAI Codex" -sidebarTitle: "OpenAI Codex" +title: "Codex" +sidebarTitle: "Codex" description: "codex-supermemory — persistent memory for OpenAI Codex CLI" -icon: "terminal" +icon: "/images/codex.svg" --- [codex-supermemory](https://github.com/supermemoryai/codex-supermemory) wires Supermemory into the [OpenAI Codex CLI](https://github.com/openai/codex) via hooks and skills. Your agent gets **two layers of memory**: diff --git a/apps/docs/integrations/eve.mdx b/apps/docs/integrations/eve.mdx new file mode 100644 index 00000000..ae56487c --- /dev/null +++ b/apps/docs/integrations/eve.mdx @@ -0,0 +1,149 @@ +--- +title: "Eve" +sidebarTitle: "Eve" +description: "Give your Eve agent memory across conversations with Supermemory." +icon: "/images/eve.svg" +--- + +Your next conversation can start where the last one left off. Supermemory gives your [Eve](https://eve.dev) agent the context to continue a project: what was decided, what changed, and the source material behind it. + +You don't need to build a separate **parsing**, **embedding**, **indexing**, or **memory-retrieval** pipeline. Supermemory handles that infrastructure. Eve's memory scope and namespace let you keep context separated by user or workspace. + +## Add Supermemory + +Start with an existing Eve project, Node.js 24 or newer, and an Eve version compatible with `eve@^0.47.3`. + + + + Run this from your Eve project: + + ```bash + eve add memory/supermemory + ``` + + Eve installs `@supermemory/eve` and creates `agent/memory/supermemory.ts`, the file that connects your agent to Supermemory. + + + + Create an [API key in the Supermemory console](https://console.supermemory.ai/keys) and add it to your project's environment: + + ```bash .env.local + SUPERMEMORY_API_KEY="your-supermemory-api-key" + ``` + + + + Start or restart Eve to load the provider and API key: + + ```bash + eve dev + ``` + + Automatic recall and conversation capture are enabled by default. The memory tools are available to your agent alongside its existing tools. + + + +You can also [install the provider manually](#manual-installation). + +## How memory works + +Two conversations about the same launch show the three parts working together: **session history**, **indexed sources**, and **memories**. + + + +After a successful turn, the provider saves the user and assistant messages as **session history**. Supermemory processes that conversation into durable **memories**, such as the launch date or the decision to keep the first release web-only. Capture is automatic; processing happens asynchronously. + +Files take a separate path. When Eve works with an attachment, URL, or text, [SuperRAG](/concepts/super-rag) parses or transcribes it into an **indexed source** the agent can read. Eve can then save a useful conclusion as a memory, retaining the source document's ID. In the example, the budget stays connected to the launch brief. + +Before a later turn, the provider loads the [user profile](/concepts/user-profiles) and searches for relevant saved context. Eve can read an earlier session or follow a source-backed memory to the original document when it needs more detail. The new conversation can then use both the earlier decision and the evidence behind it. Recall also runs after context compaction. + +## Memory tools + +The provider gives Eve seven tools alongside automatic recall and capture. The generated file is named `supermemory.ts`, so Eve prefixes their names with `supermemory__`. + + + + | Tool | Purpose | + | --- | --- | + | `search` | Find relevant memories and session history in the current memory scope. | + | `read_session` | Read a stored conversation found through search. | + | `read_document` | Read sections of a processed source, fetching more as needed. | + | `remember` | Save a standalone fact, preference, decision, or correction; optionally retain its `sourceDocumentId`. | + | `extract` | Parse, transcribe, and index an Eve attachment, URL, or text with SuperRAG. | + | `forget` | Remove one memory by ID. | + | `forget_matching` | Preview memories within a requested boundary, then remove selected IDs. | + + + + Eve can find a specific memory with `search` and remove it with `forget`. For a broader request, `forget_matching` supports a dry run that returns candidate memories. Its tool instructions tell Eve to show that preview, ask you to confirm, and remove the exact IDs you approved. + + Forgetting removes derived memories. The original session history and source documents remain stored. + + +## Choose whose memory Eve uses + +The generated memory file uses Eve's `byPrincipal` scope. In an authenticated application, memory follows the caller's identity. During `eve dev`, it uses the shared `local-dev` scope. Outside local development, anonymous and runtime principals have memory disabled. + +For a team or multi-tenant application, derive the scope from verified user and tenant identity. Eve resolves that scope before the provider runs, so the agent's tools cannot choose another user's memory. See [Eve's multi-tenant memory guide](https://eve.dev/docs/patterns/multi-tenant-memory). + +Eve also supplies a default namespace for the memory slot. You only need to set `namespace` yourself when you want a custom memory domain. Keep it stable: changing it selects a different memory space. [Eve's namespace documentation](https://eve.dev/docs/memory#namespace) explains the defaults and how to share a domain intentionally. + +## Configure the provider + +Edit the options passed to `supermemory(...)` in `agent/memory/supermemory.ts`. The generated file only needs your API key; the defaults enable automatic search and capture. + +You can adjust those behaviors independently. Set `autoSearch.enabled` to `false` to disable automatic search while keeping profile recall. Set `capture.enabled` to `false` to stop saving completed turns automatically. Both settings leave the explicit memory tools available. + + + | Option | Default | Purpose | + | --- | --- | --- | + | `apiKey` | Required | Supermemory API key, or a function returning the key synchronously or asynchronously. | + | `containerTagPrefix` | `"eve_agent"` | Prefix for storage tags derived from Eve's scope. Keep it stable to access the same data. | + | `autoSearch.enabled` | `true` | Search for context relevant to the current request during recall. | + | `profileContext.timeZone` | `"UTC"` | IANA time zone used to format profile context. | + | `capture.enabled` | `true` | Save completed turns automatically. | + | `capture.taskType` | `"memory"` | Generate memories from conversations. Use `"superrag"` to index them for document retrieval only. | + | `capture.dreaming` | `"dynamic"` | Memory generation mode: `"dynamic"` or `"instant"`. | + | `capture.entityContext` | Built-in capture policy | Instructions for what durable information to learn from conversations. | + | `capture.metadata` | `{}` | Additional metadata attached to captured conversation documents. | + + Namespace, description, and scope are Eve memory-slot settings. Configure them on `defineMemory(...)`, outside the provider options. + + +## Manual installation + +If you prefer to create the memory file yourself, install the package in your Eve project: + +```bash +npm install @supermemory/eve +``` + +Then create the same memory slot that `eve add` generates: + +```typescript agent/memory/supermemory.ts +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, +}); +``` + +Set `SUPERMEMORY_API_KEY` in `.env.local` and start your agent as described in [Add Supermemory](#add-supermemory). + +For implementation details, see the [provider repository](https://github.com/supermemoryai/eve-supermemory) and [Eve's Supermemory integration](https://eve.dev/integrations/supermemory). diff --git a/apps/docs/integrations/opencode.mdx b/apps/docs/integrations/opencode.mdx index 86872de7..e455c4a6 100644 --- a/apps/docs/integrations/opencode.mdx +++ b/apps/docs/integrations/opencode.mdx @@ -2,7 +2,7 @@ title: "OpenCode" sidebarTitle: "OpenCode" description: "OpenCode Supermemory Plugin — persistent memory across coding sessions" -icon: "/images/opencode-logo.png" +icon: "/images/opencode-logo.svg" --- [OpenCode-Supermemory](https://github.com/supermemoryai/opencode-supermemory) is an OpenCode plugin that gives your AI persistent memory across sessions. Your agent remembers what you worked on — across sessions, across projects. diff --git a/apps/docs/style.css b/apps/docs/style.css index ff7208ae..9aad7eee 100644 --- a/apps/docs/style.css +++ b/apps/docs/style.css @@ -1,5 +1,16 @@ .dark img[src*="openai.svg"], .dark img[src*="pipecat.svg"], +.dark img[src*="eve.svg"], .dark img[src*="supermemory.svg"] { filter: invert(1); } + +.dark img[src*="opencode-logo.svg"] { + content: url("/images/opencode-logo-dark.svg"); +} + +.eve-memory-video { + display: block; + width: 100%; + border-radius: 0; +} diff --git a/apps/docs/videos/eve-memory.mp4 b/apps/docs/videos/eve-memory.mp4 new file mode 100644 index 00000000..e32af87d Binary files /dev/null and b/apps/docs/videos/eve-memory.mp4 differ