RCLL 45c1a3c633 chore: default bank rcll-main, announce it, move split tool out of the root

The default memory bank becomes 'rcll-main'. hindsight-mempalace-mcp@1.0.0 (published,
~145 downloads/month) defaulted to 'mempalace-main', so an install that never set the
variable and switches packages would open a different, empty bank. MEMPALACE_BANK is
still honoured, and when neither variable is set the server now prints which bank it
picked and how to keep reading the old one, instead of choosing silently.

rcll-split.py moves to scripts/ — it documents how the fork series was built, which
is not a root-level artifact of the product.

2026-08-24 08:28:28 +03:00

3.1 KiB

Raw Blame History

RCLL MCP Server

Standalone MCP server that exposes RCLL memory tools to any MCP-compatible client (Claude Code, OpenClaw, etc). RCLL is self-hosted, hierarchical shared memory for a team of AI agents — rooms for per-agent vs shared recall, L0–L3 depth, pgvector under the hood.

RCLL — team memory for agent fleets. Built on Hindsight (github.com/vectorize-io/hindsight, MIT).

RCLL is a fork of vectorize-io/hindsight (MIT). It keeps Hindsight's storage engine and adds rooms — shared, isolated memory for a team of agents — plus a hierarchical depth model (L0–L3). The room/hall/layer taxonomy is prior art in the hierarchical-memory space; the implementation here is our own.

Tools

Tool	Description
`memory_retain`	Save memories with room/hall/layer classification
`memory_recall`	Scoped semantic search with room filtering
`memory_reflect`	Deep reasoning + synthesis over stored memories
`memory_compress`	Create closet summaries from accumulated facts
`memory_bridge`	Cross-bank tunnels between related memories

Quick Start

cd mcp-server
npm install
RCLL_URL=http://localhost:5100 node server.js

Claude Code

Add to ~/.claude/mcp.json:

{
  "mcpServers": {
    "rcll": {
      "command": "npx",
      "args": ["-y", "rcll-mcp"],
      "env": {
        "RCLL_URL": "http://localhost:5100",
        "RCLL_BANK": "my-agent-bank"
      }
    }
  }
}

Environment Variables

Variable	Default	Description
`RCLL_URL`	`http://127.0.0.1:5100`	RCLL backend base URL
`RCLL_BANK`	`rcll-main`	Default memory bank ID. Set it explicitly.

Migrating from `hindsight-mempalace-mcp`

That package defaulted to bank mempalace-main. rcll-mcp defaults to rcll-main, so an install that never set the variable would open a different, empty bank — which reads as "the update erased my memory". It does not: the old bank is still there.

Set RCLL_BANK=mempalace-main to keep reading it, or move the contents into a new bank first. When RCLL_BANK and MEMPALACE_BANK are both unset, the server prints which bank it defaulted to on stderr rather than picking one silently.

Deprecated (still read, with a notice on stderr)

Installs created before the rebrand keep working — these are used only when the RCLL_* equivalent is unset, and they will be dropped in a future major.

Legacy variable	Replaced by
`HINDSIGHT_URL`	`RCLL_URL`
`MEMPALACE_BANK`	`RCLL_BANK`

Memory Taxonomy

Rooms (topics): auth, pipeline, schema, infrastructure, ui, api, deployment, monitoring, agent, general

Halls (knowledge types — the hall field): fact, event, decision, preference, discovery, procedure, warning

Layers (depth):

L0 — Surface / identity (always at hand)
L1 — Critical (recalled by default)
L2 — Session (default for new memories)
L3 — Deepest burrow / archive (deep search only, compressed into closets)

3.1 KiB Raw Blame History Unescape Escape