rememberLABSCO SUMMARY
The memory is Markdown files you own, not rows in a database you cannot see.
The contract is the differentiator: the vault is canonical and hand-editable, the DuckDB index is disposable, and recall carries project, validity and permalinks so an agent can tell current local evidence from cross-project history. remember and recall are bound together — a successful write is immediately recallable — which is the property most memory tools quietly lack.
What it is
A durable memory server for coding agents: it captures context as inspectable Markdown with provenance, indexes it in a disposable DuckDB cache, and recalls the most relevant pieces with citations.
What you get
- remember atomically writes a Markdown note and updates the index under one writer lock, so a save is immediately recallable
- recall and search return context by meaning, fusing BM25 and semantic vectors with reranking
- build_context returns a note plus its wikilink neighbours; recent lists the latest notes
- The Markdown vault is canonical — edit a fact by hand and the next reconciled read honours it; the DuckDB index is a rebuildable cache
- One configured vault is shared across Claude Code, Codex, Cursor, OpenCode and other MCP hosts
- Credential redaction, deduplication and importance-gating before automated writes; superseded facts are demoted, not deleted
Requirements
uv, since the plugin launches through uvx. The default vault is ~/agentcairn, created on first use; the first local run downloads and warms the embedding and reranking models. Install as a first-class plugin per host — for example claude plugin install agentcairn@agentcairn — which bundles the MCP server, the memory skill and the host hooks. Local by default, stdio transport, no telemetry.
Setup effort
One command — uvx agentcairn
USE CASES
Carrying context between different coding agents
Point Claude Code and Codex at the same vault so a fact learned in one is recalled in the other.
Writing down a durable decision
Remember it once; the Markdown note and the index entry are written together, so it recalls immediately.
Pulling back the most relevant prior context
Recall by meaning, with BM25 and semantic vectors fused and reranked, each hit carrying its provenance.
Correcting a fact by hand
Edit the Markdown directly — the next reconciled read honours your edit over the derived cache.
Following the links out from a memory
Build context around a note to get it plus its wikilink neighbours.
5 tools
Listed in project docs. Your client may show a different list.
searchrecallbuild_contextrecentBEFORE YOU INSTALL
What to know first
Tools you get
5 tools named in the project's documentation.
Requires
uvx on PATH
INSTALLATION
Connect your client
Server setup
uvx agentcairnMCP Clients
Claude Code
claude plugin marketplace add ccf/agentcairn
claude plugin install agentcairn@agentcairnCodex
codex plugin marketplace add ccf/agentcairn
codex plugin add agentcairn@agentcairnCursor
uvx --from agentcairn cairn install cursorOpenCode
uv tool install agentcairn
cairn install opencodeAntigravity
git clone https://github.com/ccf/agentcairn.git
uvx --from agentcairn cairn install antigravity --source <YOUR_PATH_TO_AGENTCAIRN_PLUGIN>VS Code
uvx --from agentcairn cairn install vscodeClaude Desktop
uvx --from agentcairn cairn install claude-desktopAny MCP client
For any other MCP host, register uvx agentcairn as a stdio server in that host's MCP config; uv runs it on demand (Python 3.11+).
{
"mcpServers": {
"agentcairn": {
"command": "uvx",
"args": [
"agentcairn"
]
}
}
}