Everist
Last verified against the code: 2026-11-14 (0.10.0)
Every mistake, made once, everywhere, by morning.
Everist is an Acific Labs project in three parts: a lab paper on memory for AI agents, a protocol for
sharing what agents learn, and a product, the everist command: the memory for AI. Any agent (Claude Code,
Claude Desktop, Cursor, Codex, Gemini CLI, Windsurf, anything that speaks MCP) and any model (put
everist proxy in front of Ollama, LM Studio or any OpenAI- or Anthropic-compatible API) gets a memory that
learns from its own surprises, and they all share it.
# today, from the repository (private until launch):
git clone https://github.com/acific/everist && cd remem
uv tool install . # then:
everist setup # wires every agent on this machine, and the nightly sleep
everist proxy # memory for any model at http://127.0.0.1:11435/v1
everist share sync ~/Sync/everist # lessons between machines, verified where they land
At launch it installs by name, with no clone: uv tool install everist (or pipx install everist). The package is
built and checked for that (0.10.0: uv build, twine check, a clean install from the built file) but is not on
PyPI yet.
Today's AI agents start every session with amnesia. Millions of sessions run a day, each one learning something (a bug that only shows with that library version, a correction the person had to make twice), and at the end of every session all of it is thrown away. Everist keeps it, consolidates it overnight the way sleep does, and puts it where the agent will have it in mind next time. The paper takes it further: what one agent learns, verified by whether it predicts, can reach every agent.
- Site: https://everist.acific.com (the paper page by page, the docs, the protocol; open to everyone since
2026-11-09, when the pre-launch password came off). Built from this repository by
npm run build, served by a Cloudflare Worker (src/worker.js). - Paper: paper/EVERIST.md
- Status: 0.10.0, a working memory for Claude Code and any agent or model (read, recall by meaning, sleep into
themes, render, prime at the moment, measure, MCP, a proxy, a signed commons), judged by what it changes in what
agents do:
everist goalschecks ten goals toward a real advance from the evidence; start at docs/HANDOFF.md to pick up; see docs/GOALS.md for what is built and docs/ROADMAP.md for where we left off and what is next. - Source: github.com/acific/everist (private until launch).
How it works
transcripts ──ingest──▶ episodes ──sleep──▶ lessons ──render──▶ the agent's memory folder
(raw stream) (sessions, (what the (loaded at the start of
errors, surprises add every session)
corrections) up to) │
│ ▼
predictions ◀──verify── next sessions
- Ingest reads every Claude Code session transcript into episodes: one per session (what was asked, done, how it ended) and one per surprise inside it: a tool call that failed, or a message where the person corrected the agent.
- Recall returns the memories that match a query, scored on relevance, recency and strength together.
- Sleep consolidates: faded memories are archived; surprises that look alike merge into lessons (observations, never instructions); each lesson makes a prediction that later sessions confirm or fail, which raises or lowers its strength.
- Render writes the lessons into the project's Claude Code memory folder, and a morning report for the owner to read and veto (delete a lesson's file and it is never written again).
- Serve is an MCP server so the agent can
recallandrememberin the middle of a task.
Everything runs locally with no dependencies. With a local model running (LM Studio or any OpenAI-compatible server), gists and lessons are written in better English; without one, they are deterministic.
Run it
uv sync # once; or: pip install -e .
uv run everist status # counts and what to run next
uv run everist ingest # read new transcripts (idempotent)
uv run everist recall "pip install failed"
uv run everist sleep # consolidate, predict, render, write the morning report
uv run everist morning # what was learned last night
uv run everist setup # wire every AI agent on this machine (hooks, MCP, nightly sleep)
uv run everist proxy # memory for any model: an OpenAI/Anthropic-compatible endpoint
uv run everist context # the memory as a system prompt, for anything else
uv run everist serve # the MCP server (stdio)
uv run pytest # the tests (no model, no network)
node scripts/docs-check.mjs # the docs harness
Install it on the PATH with uv tool install . (then everist … works from anywhere), and wire it in:
claude mcp add everist -- everist serve # recall and remember, mid-task
everist hook # prints the SessionEnd hook for ~/.claude/settings.json
(crontab -l; echo "0 4 * * * everist sleep") | crontab - # sleep at 4 am
The site
npm install # once: marked (Markdown at build time) and wrangler
npm run build # site/ + the paper + every doc → dist/
npm run dev # build, then wrangler dev at http://127.0.0.1:8815
npm run deploy # build, then wrangler deploy to everist.acific.com (needs `npx wrangler login`)
scripts/build-site.mjs renders the paper into a page-by-page reader (/paper/, split at every ## heading;
site/assets/paper.js turns the pages, paper.css draws the sheet) and every doc in its list into /docs/<name>/
(/protocol/ for PROTOCOL.md), rewriting links between Markdown files into links between pages. site/ holds the
hand-written home page (site/index.html, the body only; the head and nav are shared), the styles, the fonts and marks, _headers (asset caching), robots.txt and
.well-known/security.txt. /live/ is the real store on the owner's machine (scripts/live-snapshot.py writes
site/live/snapshot.json; the build renders it). The design follows Vacuum's (vacuum.acific.com) since 2026-11-13. src/worker.js redirects http and other hosts to everist.acific.com, puts the security
headers of SECURITY.md on every response (a strict CSP: no inline scripts or styles anywhere on the
site) and can run the pre-launch gate (src/password-gate.js, a copy of the handbook's; the GATE_PASSWORD secret
turns it on; it is unset, so the gate is off).
Configuration
Every setting had the prefix REMEM_ in 0.9.x, when this was Remem, and OPENMEMORY_ before 0.9.0, when it was
Open Memory. A setting given under an old name is still read, unless its new name is set too.
| Variable | Default | What it does |
|---|---|---|
EVERIST_HOME |
~/.everist |
The database (memory.db), lessons.jsonl and morning.md |
CLAUDE_PROJECTS_DIR |
~/.claude/projects |
Where Claude Code keeps transcripts and each project's memory/ folder |
EVERIST_LLM |
1 |
0 turns the local model off (deterministic text only) |
EVERIST_LLM_URL |
the first of http://localhost:1234/v1 (LM Studio) and http://localhost:11434/v1 (Ollama) that answers |
Any OpenAI-compatible server |
EVERIST_LLM_MODEL |
first model the server lists | The model to use |
EVERIST_LLM_TIMEOUT |
120 |
Seconds to wait for one completion |
Docs
- docs/README.md: index and glossary
- docs/GOALS.md: purpose, goals with status, non-goals, principles
- docs/ARCHITECTURE.md: the components and how they fit
- docs/IMPLEMENTATION.md: how each goal is built, file by file, and the gaps
- docs/USER-GUIDE.md: every command, the morning report, vetoes, FAQ, troubleshooting
- docs/OPERATIONS.md: files on disk, the local model, the nightly job, troubleshooting
- docs/MIGRATIONS.md: how changes reach an existing memory without losing it
- docs/PROTOCOL.md: the lesson wire format and the merge rule (draft)
- docs/HANDOFF.md: where things stand right now and how to pick up
- docs/ROADMAP.md: from one agent's memory to the commons
- docs/AUDIT-LOG.md: every documentation audit
- SECURITY.md: how to report a problem, and every protection and where it lives
- CHANGELOG.md
- AGENTS.md: the contract for coding agents working here
- okaypaper/README.md: Okay Paper, the page-by-page reader and editor the paper is published in