---
title: Kybernesis Arcana
description: Give your agents workspace-scoped long-term memory with automatic recall and deliberate storage.
type: memory
keywords:
  - memory
  - long-term memory
  - semantic search
  - brain notes
  - Kybernesis
---

# Kybernesis Arcana

Memory provider integration for eve. Give your agents workspace-scoped long-term memory with automatic recall and deliberate storage.

## Install

Install the Kybernesis Arcana provider for eve:

```bash
eve add memory/arcana
```

This installs `@kybernesis/arcana` and writes a memory slot. The provider requires Node.js 24 or later and eve 0.49 or later.

## Quick start

Create an Arcana workspace and workspace-scoped API key, then add both values to the agent's environment:

```bash title=".env.local"
ARCANA_API_KEY=kb_your_api_key_here
ARCANA_WORKSPACE=your-workspace
```

The registry creates this memory slot:

```ts title="agent/memory/arcana.ts"
import { arcanaMemory } from "@kybernesis/arcana/memory";
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: arcanaMemory({
    apiKey: process.env.ARCANA_API_KEY!,
    workspace: process.env.ARCANA_WORKSPACE!,
  }),
  scope: byPrincipal,
});
```

The filename creates the `arcana` memory slot. Before each turn with at least four words, Arcana searches memories and queries brain notes, then injects the result as one context message. The provider also gives the model `arcana__remember`, `arcana__recall`, and `arcana__search` tools.

## Configure

Arcana does not capture turns automatically by default. The model stores memories deliberately with `arcana__remember`; set `capture: { enabled: true }` when you want it to capture completed turns automatically.

An Arcana key is scoped to a workspace. Keep the key in a sensitive environment variable and use a separate workspace and key when people or tenants must not share memory. The provider records eve's scope as a tag, but Arcana isolates data by workspace rather than by eve scope. See the [Arcana package documentation](https://github.com/KybernesisAI/platform/tree/master/packages/arcana#readme) for the full configuration and tool reference.

[Read the full memory provider documentation](https://github.com/KybernesisAI/platform/tree/master/packages/arcana#readme)

---

For a semantic overview of all documentation, see [/sitemap.md](/sitemap.md)

For an index of all available documentation, see [/llms.txt](/llms.txt)

For agent-facing discovery, including API and MCP surfaces, see [/agents.md](/agents.md)