Docs

Early access

Esfis is not public yet. We are letting people in a few at a time while the retrieval pipeline settles and the store format is frozen.

Ask for an invite and tell us which assistants you use. We will write when your turn comes up, with the signed build and a short setup guide.

Everything below describes the interface as it stands today. It may still move before the public release; breaking changes go in the changelog.

Connect over MCP

Any MCP client can read and write memory. Claude Desktop and Claude Code:

Copyclaude mcp add esfis -- esfis mcp

Cursor, Windsurf and other clients with a JSON config:

Copy{
  "mcpServers": {
    "esfis": { "command": "esfis", "args": ["mcp"] }
  }
}

Hosted agents that cannot reach your machine use the remote endpoint (Pro and above), protected with OAuth 2.1:

Copy{ "mcpServers": { "esfis": { "url": "https://mcp.esfis.com/v1" } } }

The server exposes five tools: recall, remember, forget, profile and blocks. Assistants call recall on their own; you never type “remember this”.

CLI

Copyesfis recall "where does Alex live"        # ranked facts with dates
esfis log --since 7d                        # commits: added · superseded · forgotten
esfis diff 2026-08-01 2026-09-01            # what changed between two states
esfis as-of 2026-06-15 "Alex"               # what you knew back then
esfis pin  <fact-id>                        # never decays
esfis export --format jsonl > memory.jsonl  # yours, always

HTTP API

The engine listens on localhost:7433. Same endpoints on the remote gateway with a bearer token.

Copyimport { Esfis } from "@esfis/sdk";

const memory = new Esfis();                       // local engine by default
await memory.add("Call with Alex: moved to Seattle, Capitol Hill.");

const facts = await memory.recall("where is Alex", { budget: 400 });
// [{ fact: "Alex lives in Capitol Hill, Seattle", asOf: "2026-09-04", score: 0.93 }]

Blocks

Blocks are Markdown files in ~/.esfis/blocks. They are injected ahead of recall, verbatim, on every request. Keep them short; they cost tokens every time.

Copy# persona.md
- Answer in Catalan unless the conversation is in another language.
- Be direct. No preambles.
- I work in Europe/Madrid; convert times for me.

Self-hosting

The Enterprise binary bundles the engine, a local extraction model and embeddings. Point it at Postgres and an object store, or run it with the embedded SQLite for a single-node trial.

Copyesfis-server --store postgres://esfis@db/esfis \
             --models /opt/esfis/models \
             --oidc https://sso.example.com \
             --no-egress

Full reference, Helm chart and hardening guide ship with the Enterprise package. Learn more.

Troubleshooting