A3S Docs
A3S CodeExamples

Memory

Practical examples for file memory, custom backends, and memory events

Memory Examples

File-Backed Memory

Memories persist across session restarts. Point multiple sessions at the same directory to share long-term knowledge.

import { Agent, FileMemoryStore } from '@a3s-lab/code';

const agent = await Agent.create('agent.hcl');

// First session
const s1 = agent.session('.', { memoryStore: new FileMemoryStore('./memory') });
await s1.send('Remember: we deploy to AWS us-east-1 via GitHub Actions');

// Later session — same memory dir
const s2 = agent.session('.', { memoryStore: new FileMemoryStore('./memory') });
const result = await s2.send('Where do we deploy?');
from a3s_code import Agent, SessionOptions, FileMemoryStore

agent = Agent.create("agent.hcl")

s1 = agent.session(".", SessionOptions(memory_store=FileMemoryStore("./memory")))
s1.send("Remember: we deploy to AWS us-east-1 via GitHub Actions")

s2 = agent.session(".", SessionOptions(memory_store=FileMemoryStore("./memory")))
result = s2.send("Where do we deploy?")

Storing Memories Directly

Use session.memory() to store and query memories from your own code:

For the full API reference, see Memory.

On this page