xm

Shared memory infrastructure for heterogeneous LLM agents over an open network.

Overview

xm is a research project exploring how LLM agents (Claude, GPT, Gemini, local models) can share persistent, linked memory. The core component is xm (Linked Memory), a CLI tool that any agent can use to store and retrieve knowledge.

Use Cases

Cross-Agent Memory

Claude Code debugs an API, GPT-4 reviews the fix later:

# Claude Code stores what it learned
xm node create -t fact -p content="Auth bug was in token refresh logic" \
 -p source="claude-code" -p context="debugging session 2024年01月15日"
# GPT-4 queries for context before code review
xm query nodes --type fact --filter "source=claude-code"

Long-Term User Preferences

Agents remember user preferences across sessions:

# Store preference
xm node create -t preference -p user="hugo" \
 -p content="Prefers functional programming style"
# Any agent can query later
xm query sparql "SELECT ?pref WHERE { ?s a xm:preference ; xm:content ?pref }"

Project Knowledge Graph

Build linked knowledge about a codebase:

# Create entities
xm node create -t entity -p name="auth-service" -p kind="microservice"
xm node create -t entity -p name="user-db" -p kind="database"
# Link them
xm link create auth-service user-db -t "depends-on"
# Discover relationships via backlinks
xm query backlinks user-db

Capability-Controlled Sharing

Share read-only access to specific knowledge:

# Create attenuated capability (read-only, expires in 7 days)
xm cap attenuate root-cap --permissions read --ttl 7d
# Export as sturdyref for another agent
xm cap export cap-123 --format sturdyref

Remote Knowledge Graph Access (Two Agents)

Alice (research agent) shares her knowledge graph with Bob (writing agent) over OCapN:

# === ALICE'S MACHINE ===
# Start daemon with OCapN networking
xm daemon start --listen tcp://0.0.0.0:8555
# Alice builds a research knowledge graph
xm node create -t topic -p name="Climate Policy" -p domain="research"
xm node create -t source -p title="IPCC Report 2024" -p url="https://..."
xm link create "Climate Policy" "IPCC Report 2024" -t "cites"
# Create read-only capability for Bob
xm cap create --permissions read,query --name "bob-research-access"
# Export as sturdyref (secure, unforgeable reference)
xm cap export bob-research-access --format sturdyref
# Output: ocapn://tcp-tls/alice.local:8555/s/a3f8c2...
# === BOB'S MACHINE ===
# Bob connects using the sturdyref
xm --remote "ocapn://tcp-tls/alice.local:8555/s/a3f8c2..." \
 query sparql "SELECT ?topic ?source WHERE {
 ?t a xm:topic ; xm:name ?topic .
 ?t xm:cites ?s .
 ?s xm:title ?source
 }"
# Bob can query Alice's graph but cannot modify it
xm --remote "ocapn://..." node create -t note -p content="..."
# Error: capability does not permit 'create' operation
# Bob stores his own notes locally, linking to Alice's research
xm node create -t draft -p content="Based on climate research..." \
 -p references="ocapn://tcp-tls/alice.local:8555/s/a3f8c2..."

┌─────────────────┐ ┌─────────────────┐
│ Alice (Agent) │ │ Bob (Agent) │
│ │ OCapN/CapTP │ │
│ Research Graph │◄──────────────────►│ Writing Draft │
│ - Climate │ sturdyref: │ - References │
│ - Sources │ read+query only │ Alice's data │
└─────────────────┘ └─────────────────┘

Components

meld/
├── xm/ # Linked Memory CLI tool
├── SPEC-029-*.md # xm specification
└── users/ # User personas and scenarios

See xm/README.md for installation and full command reference.

License

AGPL-3.0-or-later

Copyright 2026 Hugo O'Connor, Anuna Research