A distributed memory
for your coding agents.

You consumed 50 articles this week. Your coding agent saw none of them. wellinformed fetches from ArXiv, HN, RSS, blogs, any URL — indexes your codebase, deps, git history — and now shares rooms across peers via Y.js CRDT, searches federated across the P2P network, and parses codebases into a structured code graph. 15 MCP tools, sub-100ms, local-first.

Install in 3 commands See the code

v2.0 stats

2.7K

Nodes

MCP Tools

243

Tests

Before / After

What your agent can do now

Without wellinformed, Claude guesses from training data. With it, Claude cites your actual research.

MCP Native

15 tools your agent calls

search, ask, get_node, find_tunnels, federated_search, code_graph_query. Claude uses them without copy-paste.

P2P Sharing

Rooms sync across peers (Y.js CRDT)

Mark a room shared, connected peers sync it via a custom libp2p protocol. Metadata-only replication, 14-pattern secrets scanner, symmetric in/out. No raw vectors (inversion-attack safe).

Federated Search

Query across the network

ask --peers embeds locally, fans out to connected peers with 2s timeout, merges by distance with _source_peer annotation. mDNS auto-discovers on LAN. DHT wired for internet-wide.

NAT Traversal

Production P2P networking

libp2p circuit-relay-v2 + dcutr hole punching + UPnP port forwarding. Bandwidth limiter, passive health monitoring, auto-reconnect. 10-peer mesh verified in ~2.5s.

Structured Code Graph

Parse codebases with tree-sitter

9 node kinds (class, function, method, interface...), 5 edge kinds (contains, imports, calls...), call graph with confidence levels. Separate from research — codebases attach to rooms via M:N join table.

Active Fetching

8 adapters + discovery loop

ArXiv, HN, RSS/Atom, any URL, codebase, npm deps, git submodules, git history. Discovery loop recursively expands from indexed keywords.

Local-first

No cloud, no API keys

ONNX embeddings, sqlite-vec search. ed25519 peer identity. All state under ~/.wellinformed/. Works offline, syncs when peers reconnect.

Functional DDD

Built clean

neverthrow Results, no classes in domain/app, error union discipline per bounded context. 243 tests across 5 phases, zero regressions.

Real output

One query, three source types

Your agent searches "sqlite vector" and gets a dependency, your own code file, and a blog post — all in one result.

$ wellinformed ask "embeddings RAG vector database"

# wellinformed results

## NirDiamant/RAG_Techniques (26K stars, GitHub Trending)

distance: 0.875 | source: github.com

## qdrant/fastembed (2.8K stars, GitHub Trending)

distance: 0.929 | source: github.com

## Knowledge Graph Embeddings (Hacker News)

distance: 1.025 | source: news.ycombinator.com

GitHub repos + HN stories + your code — auto-discovered sources, one query

MCP protocol

15 tools your agent calls without asking

Register globally once with claude mcp add --scope user wellinformed -- wellinformed mcp and every new project has all 15 tools available immediately. No per-repo setup.

searchRoom-scoped semantic k-NN

askSearch + assembled context block

get_nodeFull attributes by ID

get_neighborsGraph traversal from a node

find_tunnelsCross-room similarity pairs

trigger_roomFetch + embed + index

graph_statsNode/edge/vector counts

room_createCreate a new room

room_listRegistry with metadata

sources_listConfigured source descriptors

discover_loopRecursive source expansion

federated_searchQuery across connected peers

code_graph_queryStructured code graph query

BEIR methodology, real ONNX

Standardized benchmarks

Full BEIR v1, all-MiniLM-L6-v2 + sqlite-vec

BEIR SciFact (5,183 × 300)

NDCG@10: 64.82% (BM25=66.5%, BGE-Large=74.6%)

Recall@5: 74.84%

MRR: 0.604

Latency: p50 2ms · p99 3ms

BEIR NFCorpus (3,633 × 323, biomedical)

NDCG@10: 31.35% (BM25=32.5%, ref MiniLM=28-32%)

Latency: p50 1ms · p99 2ms

Matches published baseline for all-MiniLM-L6-v2 on both datasets.
We do not claim SOTA — we match the ceiling of our chosen (fast, local, no-GPU) embedding model.

Reproduce: node scripts/bench-beir.mjs scifact

Research channels

Beyond source adapters, wellinformed taps into the GitHub analytics ecosystem for trend tracking and competitive intelligence.

star-history.com Daily Stars Explorer OSS Insight Repohistory RepoBeats Gitstar Ranking Ecosyste.ms Timeline X / Twitter Instagram AI/ML

Claude Code — auto-discovered

Codex — MCP server

OpenClaw — MCP bridge

Any MCP host — stdio

A distributed memoryfor your coding agents.