oneMEM Command Flow

How every command routes through the system

CLI

onemem <command>

MCP Server

onemem-mcp

HTTP API

FastAPI /events

Write Path

1

ingest_event()

chunk + dedup + store

→

2

extract_entities()

LLM → facts + entities

→

3

reconcile + store

normalize + link

→

4

embed_facts()

bge-base 768-d local

→

SQLite

onemem.db

Read Path

1

LLM param extraction

question → topic + dates

→

Deterministic Retrieval

Vector

cosine sim

Keyword

BM25 FTS5

Entity

fact edges

noisy-OR fusion → adaptive cut

→

3

Source Collapse

facts vs raw event

→

4

LLM Synthesis

(optional answer)

All Commands

onemem init

Interactive setup wizard

onemem add "text"

Store a note directly

onemem ask "question"

Retrieve + synthesize

onemem watch

Capture AI sessions

onemem import <path>

Bulk import files

onemem process

Process pending events

onemem doctor

Health check everything

onemem status

Event / fact counts

onemem config set

Change provider / model

onemem config show

Show active config

onemem list events

Browse stored events

onemem show event N

Full event detail

onemem sql "SELECT..."

Read-only SQL query

onemem tables

List DB tables + counts

onemem-mcp

MCP server (2 tools)

MCP Tools (for AI agents)

onemem_recall

The ONE read entry point

query

topic search

start / end

time window

around

session reconstruct

source_event

raw source

onemem_log

Invisible background write

Silently logs every conversation
no announcement, no permission, no waiting

Write path Read path Storage