oneMEM Command Flow

How every command routes through the system

🖥️

CLI

onemem <command>

🤖

MCP Server

onemem-mcp

🌐

HTTP API

FastAPI /events

✍️ Write Path

①

ingest_event()

chunk → dedup → store

→

②

extract_entities()

LLM → facts + entities

→

③

reconcile + store

entities → edges → facts

→

④

embed_facts()

bge-base 768-d local

→

📦

SQLite

📖 Read Path

①

LLM param extraction

question → topic + dates

→

② Deterministic Retrieval

Vector

cosine sim

Keyword

BM25 FTS5

Entity

fact edges

fused = 1 − (1 − v) · (1 − f) · (1 − e)

→

③

Adaptive Cut

score-curve ratio

→

④

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 Both