A3S Docs
A3S Code

Memory

Session memory stores and explicit recall

Memory

Memory records reusable facts about previous work. It should help the harness recall patterns without flooding every prompt.

Configure Stores

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

const session = agent.session('/repo', {
  memoryStore: new FileMemoryStore('./.a3s/memory'),
});

Use memory storage in short-lived tests and file storage for durable local sessions.

Write Memory

await session.rememberSuccess(
  'release preflight',
  ['bash', 'grep'],
  'Release checks passed after provider verification',
);

await session.rememberFailure(
  'provider verification',
  'missing A3S_OPENAI_BASE_URL',
  ['bash'],
);

Recall

const related = await session.recallSimilar('release provider verification', 5);
const recent = await session.memoryRecent(10);
const tagged = await session.recallByTags(['release'], 10);

Use recalled memory as supporting context. Verification evidence still comes from current commands and traces.

On this page