Quick start

Get memory running locally and confirm that your agent can remember and recall a fact across sessions.

Prerequisites

A Linux or macOS machine.
Shell access and curl.
An MCP-compatible agent or editor.

1. Install

Run the installer:

curl -fsSL https://0d3sa.com/memory/install.sh | sh

This downloads the right binary for your platform, verifies its checksum, and installs it to ~/.local/bin/od3sa-memory. If your terminal is interactive, the installer will prompt you for an MEMORY_ORG_ID and write it to ~/.memory/.env. You can leave it empty and configure it later.

For non-interactive installs, set the organization ID ahead of time:

export MEMORY_ORG_ID=your-org
curl -fsSL https://0d3sa.com/memory/install.sh | sh

If you prefer a manual install, see Downloads and checksums.

2. Verify

Check the binary:

od3sa-memory version

Check for updates without installing:

od3sa-memory update --check

Then confirm it can open its database:

od3sa-memory health

You should see a version string and a health report with status: ok. If either command fails, make sure ~/.local/bin is on your PATH, or use the full binary path.

3. Connect your agent

If you use Claude Code, the fastest path is the built-in setup helper, run from your project directory:

cd ~/my-project && od3sa-memory setup claude

It prompts for an agent identity and a personal-vs-team scope, then writes a project-local .env, registers the MCP server in ~/.claude.json, and installs /memory-* slash commands. See Connect Claude Code for the full walkthrough.

For other clients, memory speaks MCP over stdio. Pick the tutorial for your client:

If your MCP client uses Streamable HTTP instead of stdio, see Run a local HTTP MCP server.

If you already know your client’s mcpServers JSON, the server command is:

/home/yourname/.local/bin/od3sa-memory --db /home/yourname/.memory/default.db

Replace /home/yourname with your actual home path and use absolute paths. Then restart your client.

4. Remember and recall

Ask your agent to remember something:

Remember that I prefer Python examples and short sentences.

Then start a new conversation and ask:

What do you know about my communication preferences?

The agent should recall the preference from the local store.

Expected output

od3sa-memory version prints a version string.
od3sa-memory health returns status: ok.
A remembered fact is returned when asked in a new session.

What memory does

memory stores memories in a SQLite database at ~/.memory/default.db. Each memory gets a 256-dimensional embedding. When the agent runs memory_recall, memory compares the query embedding to stored vectors and returns the closest matches.