memsearch

Semantic memory for the agent Host: agents accumulate memory across sessions and across worktrees, and it survives the box. Docs: github.com/zilliztech/memsearch. Decision record: ADR-0064.

• URL: none; a CLI and a library, not a service
• Data: /srv/agent-memory/.memsearch/memory (markdown, replicated off-box), ~/.memsearch/milvus.db (index, disposable)
• Backup: none, by decision — the agent Host holds no state a backup is the answer for (ADR-0054)

Deploy

auberge ansible run --tags memsearch -H ruche

Configuration

Key	Description
memsearch_sync_device_id	Syncthing device ID of the peer that holds the off-box copy
memsearch_sync_device_name	How that peer appears in the Host’s device list

The peer initiates the connection. The Host announces nowhere, so pair it from the peer’s side using the Host’s tailnet address and port 22000. auberge syncthing pair does this on the machine running auberge, and again after a rebuild gives the Host a new device ID.

Notes

The store is markdown and the index is rebuilt from it, so losing the box loses the index and nothing else:

rm -f ~/.memsearch/milvus.db
memsearch index /srv/agent-memory/.memsearch/memory

Each agent worktree keeps its own capture daemon and its own collection over that one shared corpus — an agent in one worktree therefore recalls what an agent in another learned. The reason it is not one collection, and the cost of that, are in ADR-0064.