Kybernesis Arcana

Install Kybernesis Arcana for eve:

eve add extension/arcana

This installs @kybernesis/arcana and writes an extension mount. The package requires Node.js 24 or later.

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

ARCANA_API_KEY=kb_your_api_key_hereARCANA_WORKSPACE=your-workspace

The registry creates this mount:

import arcana from "@kybernesis/arcana";
export default arcana({  apiKey: process.env.ARCANA_API_KEY!,  workspace: process.env.ARCANA_WORKSPACE!,});

The filename supplies the arcana namespace. The extension adds an MCP memory connection, recall, remember, and brain-note skills, and instructions that tell the model to search the workspace before it claims not to know something.

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 model can choose what to store and retrieve, but it cannot choose the configured key or default workspace.

You can select a workspace per session with resolveWorkspace. Derive it only from verified session context, and only return workspaces that the configured key can access:

import arcana from "@kybernesis/arcana";
export default arcana({  apiKey: process.env.ARCANA_API_KEY!,  workspace: process.env.ARCANA_WORKSPACE!,  resolveWorkspace: (ctx) =>    ctx.session.auth.current?.attributes.surface === "dm"      ? process.env.ARCANA_DM_WORKSPACE      : undefined,});

Arcana stores memories, embeddings, timeline entries, and brain notes in the selected workspace. The shipped instructions tell the model not to store passwords, access tokens, payment data, private keys, or one-time codes; add approval rules to memory-write tools when you need an enforced control. See the Arcana package documentation for the full configuration and tool reference.