Skip to content

Give your agent a memory in five lines.

remember() writes. recall() retrieves. Every record comes back typed and source-linked, with audit built in. Bring your own model keys; we run the memory.

MCP-compatible interface

Protocol-native by default.

The memory layer is MCP-compatible end to end. A focused public MCP interface exposes read, write, and retrieval. Advanced orchestration and behavioural enforcement remain internal.

Runtime primitive

Three verbs. One mental model.

Remember creates the record. Recall returns scoped context. Forget removes records while preserving the audit trail.

memory.tstypescript
await octa.remember({
  scope: "acme/launch",
  type: "episodic",
  content: "Beta opens March 20.",
  sources: ["linear:OCT-42"]
});

id

mem_01HZ

source

linear:OCT-42

audit

evt_3921

§ 01Plugin

Claude Code and Codex. One install.

The official OctaMem plugin connects Claude Code and Codex to the hosted MCP server. Sign in once in the browser, pick a memory, and your coding assistant can search and save to it. No API keys in config files.

Shell
# Claude Code
claude plugin marketplace add OctaMem/octamem-plugin
claude plugin install octamem@octamem

# Codex
codex plugin marketplace add OctaMem/octamem-plugin
codex plugin add octamem@octamem
codex mcp login octamem
Install, then authenticate with /mcp in Claude Code or the login command in Codex.

§ 02API surface

Clean, consistent endpoints.

The same memory primitives across every interface. Pick the surface that matches your runtime. The contract is identical between REST, the Python and JavaScript SDKs, and MCP.

  • Authentication

    Bearer · X-API-Key

    OCTAMEM_API_KEY in the Authorization header.

  • Memory · add

    POST /api/memory/add

    Store content as memory with optional prior context.

  • Memory · search

    POST /api/memory/search

    Query memory in natural language and get the result back.

  • Usage & account

    GET /api/memory/details

    Key validity, plan, memory used, and wallet balance.

  • Python SDK

    pip install octamem

    Typed, async-first. Works with any async runtime.

  • JavaScript SDK

    npm install octamem

    TypeScript-first. Edge-runtime compatible.

§ 03Quick start

Quick start examples.

Remember a record, recall it, inspect the source. Same shape across Python, JavaScript, and the REST API.

add_memory.py · python
from octamem import OctaMem

client = OctaMem(api_key="YOUR_API_KEY")

client.add(
    content="Launch date set for April 15. Beta opens March 20.",
    previous_context="Q1 product planning meeting",
)

§ 04Use cases

Where builders plug it in.

Long-term memory plugs into the shapes teams are already building. Four common patterns OctaMem is shaped for.

  • 01

    Chatbots.

    Long-term memory across sessions and model switches. The chatbot stops repeating itself.

  • 02

    AI Agents.

    Agents retain behavioural context, decisions, and preferences across tasks.

  • 03

    Copilots.

    Developer copilots that remember project structure, conventions, and patterns.

  • 04

    RAG Pipelines.

    Augment retrieval with structured user memory for personalised, traceable results.

§ 05Ready to integrate

Get your API key. Start building.

Builder includes 5,000 MOps a month, 10 GB of memory, and full SDK access for $49 a month. Move to larger workspaces, longer audit retention, or sovereign deployment when you need them. The code stays the same.

Builder · $49/month · 5,000 MOps · 10 GB included.