recollect · agent-native memory · 2026

A traceable
agent memory substrate

The hub stores raw transcripts, runs extraction and publishes snapshots. A node on each machine follows along, and keeps organising locally when the network is down. Agents read what matters into context through one fixed entry point. Many devices and many agents share one copy, and by default it only runs on a trusted private network. Raw transcripts are the only source of truth; memory is just an index pointing at them.

Recall in plain language One executable Shared across machines and agents Import any session Traceable and retractable
0Crates
Rust workspace
Contracts, storage, network and surfaces each in their own crate
0Tests
Test functions
No "success" flag; we look at how many rows were actually written
0Tables
Memory tables (schema v6)
Identity, provenance and audit each own a table
0Tools
13 shared memory tools + 28 private tools
The rest are for operations and debugging

Figures measured from the repository on 2026-11-09.

What a recall looks like · view=brief Nothing is generated at read time

You discussed the deploy script on 10-22 and settled on one path: build-release.sh[1]; x86 and ARM artifacts each ship with SHA256SUMS[2]; cold-start readings live in that docs note, not in the memory body[3]。

For an LLM, reading one organised sentence costs less than parsing scattered fragments; the more scattered the fragments, the more likely the model fills the gaps itself.

Full sentences carry contextFragments and field dumps are not organised into context, so models fill the gaps. A complete sentence makes the who, the what, the time and the cause explicit, and is harder to misread.
No model call at read timeSentences are assembled by a template in code. Since nothing is generated on the read side, nothing can be invented at read time, and one round trip is saved.
Evidence on demandEvery [n] is a handle: follow it back to the original words. The full text never goes into the context.
The same candidates can also be read as JSON, cards or an evidence chain. See the four read modes
01

Three claims decide everything else

This is not a feature list but a set of trade-offs. Each one below maps to a constraint in the code; read these three first and every pipeline that follows has a reason.

0 / 1

Code locates,
the LLM judges meaning

Ordinals, timestamps, speakers, tool calls, mentions, dedupe and provenance are all computed in code. Only the semantic judgements — entities, facts, relations, mood, ambiguity — go to the model, one question at a time.

0 / 2

Raw records are the source of truth;
memory is the index

A memory row holds a conclusion, a pointer to the source, and provenance. Full conversations, tool output, code and logs stay in the raw layer; when needed, follow the pointer back instead of copying the text into memory.

0 / 3

Identity is stable;
location is not

Identity is a computed hash: move it to another machine, import it again, and it is still the same record; seq a display number is not identity. Wherever the hub moves, the number still points at the same thing.

02

Two kinds of agent, two different priorities

One store, one pipeline. The difference is who plugs in and what has to be in front of it.

companion

Companion

Three weeks of conversation, still connected the next day: who you are, how you felt, and how that thing turned out.

Persona Profile Mood Events Causality Notebook
Always-on brief · mood and state · events and causality · notebook
See the scenario
engineering

Engineering

A project spanning three weeks, still readable by the next person: who changed what, why, and who owns the next step.

Timeline Notebook Handoff note Closed loop Verifiable
Timeline · notebook · handoff note · closed loop · raw words
See the scenario
Dafeiyu (whale girl) artwork
SOLO · one device

One computer and one companion still works

This machine is the hub; pairing, replication and cross-machine reads stay in the drawer. See what runs and what never needs to start.

See how solo works Dafeiyu (whale girl) · community fan art, unofficial
03

One hub, many edges, one authority

The hub itself needs no agent; each device runs a local node. A backup catches up entry by entry along the replication sequence and may only take over after verification; takeover rotates the credential, so anything the old hub still sends is rejected.

01 / edge · device 02 / hub 03 / standby · backup agent on the device Claude Code · Qoder · DSH · MiniMax Converter · ingest v2/v3 Ingest acceptance · no lost fields · all four sources pass recollect-node replica/ read-only copy pending.db offline staging dr/ self-backup · device.key node-state.json Surfaces mcp · hook · doctor brief / card / json / expand hub · centre (agent optional) transcript.db raw transcripts memory.db memory · 25 tables core.db · encrypted notebook per agent ledger.db ledger (stays in the hub) Resolve handles / attribute / quota Extraction scheduling · review · audit /v1/pair · challenge · ingest · rows · state /v1/snapshot/memory standby · backup Incremental copy along the replication sequence Catch up + verify → take over Rotate credential · old hub rejected Missing entries ⇒ report unavailable + gap Secret box · decided separately Not copied with backups; the passphrase is archived separately Pair / ingest Rows / snapshots / transcript reads Replication sequence

The diagram shows the main path only. Offline, half-partitioned, local distillation and merge-back are rehearsed as an interactive state machine on the Reliability page.On narrow screens, scroll sideways to see the full diagram.

Open the full topology
04

From one session to an expandable recall

Write and read are independent paths, separated only by a memory layer that can be rebuilt. Extraction failures, prompt revisions or a model swap never lose the original session.

01 / INGEST

Import

Each agent's own converter writes sessions into one format; if ingest checks fail, the converter is fixed. The core accepts no private format.

02 / EXTRACT

Extraction

Code locates first, then the LLM takes on semantic tasks. Every output carries only seq and a verbatim quote; no other fields are accepted.

03 / REVIEW

Review

Code checks everything that can be checked mechanically; then a separate model review flags problems without rewriting or re-extracting. Rejected drafts carry a reason.

04 / COMMIT

Land

The conclusion, handle and provenance enter the memory layer; the raw text stays in the transcript. Tests look at rows actually written — zero rows is an error.

05 / RECALL

Recall

By default you get a brief with handles — the marker at the start of each line — [1]; use it to fetch that memory. The turn pointer in the memory then takes recollect_turn you back to the raw words. Programs read json; reviewers use expand to see the evidence chain.

06

Why it is built this way

Each one answers a real trap we hit; nothing is complex for its own sake.

Close the conversation and the context is gone
→
The raw text stays; a pointer finds it any time
Models invent, especially times and numbers
→
Code locates; the model only judges meaning
When a conclusion does not match its source, you cannot see where it went wrong
→
Every row carries the source position and time; it can be retracted or superseded
Swap the model and everything has to be redone
→
Memory holds conclusions only; the raw text is untouched, so a re-run is enough
On a small machine, embedding models are too heavy
→
Start with exact keyword recall; add vectors as an optional table later, never in the core
One person cannot maintain a fleet of services
→
One binary, SQLite only, no message queue
One executableNo external services, no console window; copy it over and run.
One machine is the hubWithout a hub, this machine is the hub; with one, it is just another role.
SQLite onlyNo message queue, cache or search cluster; when something breaks you can open the file and look.
Keeps working offlineOne day offline, keep organising locally; five days, act as your own hub; when the network returns, merge back in a fixed order.

Memory should be groundwork,
not a by-product of a plugin.

Start with the architecture 9 pages · interactive · opens offline