Build agents that understand before they act.
Weavatrix turns a changing repository into a living evidence graph: structure, history, intent, memory, risk, and proof. It is open infrastructure for AI software agents whose intelligence should grow with the code—without hiding uncertainty or crossing a trust boundary by accident.
Get startedExplore the ecosystem →
# native, offline, zero runtime dependencies
$ claude mcp add -s user weavatrix -- npx -y weavatrix mcp <repoRoot>
# same for Codex:
$ codex mcp add weavatrix -- npx -y weavatrix mcp <repoRoot>
# or install the same MCP product from crates.io:
$ cargo install weavatrix
$ weavatrix mcp <repoRoot> --profile=code
# Search Evidence Graph — CLI and MCP are the same binary
$ npx -y weavatrix-seo mcp --allow-root .
# then, inside Claude Code:
› what breaks if I change the auth middleware?
→ change_impact: 3 changed files map to 9 symbols; 41 dependents in blast radius,
7 untested hotspots called out — ranked by proximity × connectivity.
SEOSearch Evidence GraphCLI and 15 MCP tools. Audit the live site and name the source that produced it.
ECOSYSTEMSee the whole stackAgent products, Rust engines, measured proof, research, and every public project.
BLOGRead the field notesDesign decisions, benchmarks, trust boundaries, and research from the graph.
RESEARCHFollow emerging intelligenceHeterogeneous systems, semantic composition, durable memory, and verifiable agents.
One family. Four public products. Explicit trust boundaries.
Core is network-free and source-read-only. SEO is a Search Evidence Graph over the live site and the code that produced it. Refactor adds reviewed local writes. Online adds an authorized network connection. All four public packages are MIT.
NATIVE · FREE · OPEN SOURCE
Weavatrix Core 1.10.0
MITThe native MCP product for coding agents: 44 read-only tools for application maps, exact context, Health, dependencies, duplicates, blast radius, APIs, Git, search, semantic links, memory and architecture ratchets.
- No network path, source-write path, install script, runtime download or external executable.
- The same native adapter ships through Cargo and npm for Windows, macOS and glibc Linux on x64 and arm64.
- Backed by
weavatrix-rust 2.9.0 and weavatrix-graph 0.6.3, with 24 code and repository surfaces.
$ npx -y weavatrix mcp <repoRoot>
$ cargo install weavatrix
SEARCH EVIDENCE · READ-ONLY · MIT
Weavatrix SEO 0.6.2
MITA Search Evidence Graph for code-driven sites. CLI and 15 MCP tools are the same native binary. Live HTTP, repository routes, schema, and claims stay revision-bound. Missing evidence is UNMEASURED, never green by silence.
weavatrix-seo mcp is the agent socket, not a second product.- A finding can name the Next.js, Nuxt, or Astro helper that emitted the title.
- SEO never writes pages or applies patches;
seo_plan can hand a location to Refactor.
$ npx -y weavatrix-seo audit --site https://example.com --json
$ npx -y weavatrix-seo mcp --allow-root .
WRITE LAYER · OPEN SOURCE
Weavatrix Refactor 1.0.11
MITA separately installed layer that composes Core and adds 11 MCP methods for evidence-backed plans, write-gated apply and drift-checked rollback.
- The
rename profile exposes only rename_symbol and rollback_last_apply, reducing fixed MCP context from 9,331 to 485 measured tokens. - Applying a plan requires
WEAVATRIX_ALLOW_SOURCE_EDITS=1 and a plan-bound single-use token; the profile narrows context but does not grant write authority. - Writes are journaled and crash-recoverable. Other processes can still observe an intermediate filesystem state.
AvailabilityFull refactoring layer · preview-gated writes · retained rollback
NETWORK LAYER · OPEN SOURCE
Weavatrix Online 0.3.2
MITA focused network MCP with seven methods for endpoint status, advisory refresh, malware review, architecture contracts and preview-confirmed graph sync. It does not bundle Core or Refactor.
- Connects to Weavatrix Cloud or a compatible customer-controlled endpoint.
- Sync is explicit and source-free: no source bodies, snippets, absolute paths, credentials or Git remotes.
- Install Core and Refactor separately when an agent also needs local repository intelligence or source edits.
AvailabilityPublic MIT client · Cloud access controlled by endpoint authorization
Clear boundary: Core, SEO, Refactor, and the public Online connector are MIT. SEO reads the origins you name; it does not write pages. Write authority still requires Refactor's gates.
The protocol-independent Rust engine beneath Core.
weavatrix-rust@2.9.0 is the reusable repository-intelligence engine and library. It does not implement an MCP server; weavatrix@1.10.0 owns the MCP adapter and ships the same native product through Cargo and npm.
EMBEDDABLE · PURE RUST · READ ONLY
weavatrix-rust 2.9.0
MITBuild repository-aware Rust systems from typed analyzers, deterministic snapshots, evidence graphs and 44 bounded operations—without importing a transport into the engine.
- Lossless parsing across 24 code, API, infrastructure, configuration, document and UI-source surfaces.
- Optional Git, search, clone, vector, semantic and temporal-memory capabilities layer evidence over
weavatrix-graph 0.6.3. - Duplicate results keep families, members and pair IDs coherent after filtering; the standalone binary identifies itself as
weavatrix-rust. - Use the Rust facade as a library or the standalone engine CLI; choose
weavatrix when the application needs MCP.
[dependencies]
weavatrix-rust = { version = "2.9.0", default-features = false }73.21 msmedian full graph build, three basic release runs
7.436 msunchanged repository refresh
0.661 msmean hot graph-stats call across a 1,000-call load run
87.71%Rust line coverage release gate
The basic 2.0.2 verification uses the native engine against its committed 192-file repository: 1,531 nodes and 7,287 edges. Coverage also records 80.57% of functions and 85.30% of regions. The short load run is intentionally bounded rather than presented as an exhaustive performance study. Reproducible methodology and component evidence remain published with the Rust repository.
The graph your agent is missing
This is not one report or three fixed workflows: 44 methods project the same reusable graph into the smallest view needed for each task. Grep sees text; Weavatrix sees structure: files, symbols, runtime edges and compile-time coupling — including Rust module paths, Java OOP relationships, project-internal Java receiver call flow, and Swift same-module types with HTTP/WebSocket clients. Typed adapters build semantic evidence for code, contracts and infrastructure, while the lossless parser preserves every supported source surface without pretending that CSS and Rust have the same semantic depth. A bounded, package-pinned TypeScript/JavaScript LSP overlay verifies ambiguous references locally without a native compiler or network request.
Fast application understanding
module_map, communities, endpoints and focused graph/context views turn a large unfamiliar repository into a bounded workset before the agent starts reading files.
Proof-carrying change safeguard
verified_change plans and verifies one change through exact context, blast radius, graph drift, architecture, duplicate, API and optional test ratchets, returning PASS, BLOCKED or an explicitly incomplete evidence state.
Change impact
change_impact diffs your branch (staged, unstaged, untracked included) and lists everything that depends on what you touched — with test coverage attached and untested hotspots called out.
Blast radius per symbol
get_dependents walks reverse edges transitively: every caller, importer and subclass that can feel your refactor, ranked by proximity and connectivity.
Signal-aware health audit
run_audit finds dead code, dependency mistakes and orphans, separates runtime cycles from compile-only coupling, and reports a capability matrix so missing local JARs, dynamic build logic, runtime, concurrency or advisory evidence can never look clean.
Exact REST and symbol context
list_endpoints proves declared versus reachable routes, mount chains, client calls and conditional Spring controllers, including Swift URLSession and WebSocket clients. trace_endpoint follows one route; context_bundle ranks production callers and preserves call-site provenance.
Cross-repo API contracts
trace_api_contract joins HTTP, GraphQL, gRPC and event contracts across registered local repositories. Fresh revision-bound runtime or OTLP evidence confirms dynamic identities; uncaptured paths remain explicitly unproven instead of being guessed.
Clone detection, three lenses
find_duplicates uses MOSS winnowing over method bodies and embedded strings. It ranks near-clones and same-name divergence as review evidence while suppressing homogeneous router boilerplate by default.
Structural diff
rebuild_graph + graph_diff report the architecture delta of your edits: runtime versus compile-time dependencies, changed cycle membership, and symbols that lost their last caller.
History-backed architecture
git_history combines bounded local churn with graph connectivity, hidden co-change coupling and expected test/source movement. It reads numstat evidence, not commit messages, authors or source bodies.
Intended architecture ratchet
get_architecture_contract previews an adaptive Maven/Gradle/monorepo target before an explicit one-time approval; prepare_change and verify_architecture enforce it without silently rewriting policy.
One-call multi-repo mode
open_repo switches the active local repository and builds missing graphs through an explicit offline tool call. It also upgrades legacy graphs to edge metadata v2; omit retarget to pin one repository.
Code and schemas
Symbols, imports, ownership, calls and domain evidence where the source can prove them.
RustJavaScript / JSXTypeScript / TSXPythonGoJavaC#CC++SQLBash / ZshSwiftSolidity
Contracts and configuration
Typed API, deployment and configuration facts with exact source spans.
GraphQLProtobuf / gRPCJSON / JSONC syntaxKubernetes YAMLTerraform / HCLXML
Documents and UI sources
Lossless structure and byte-for-byte source recovery for repository context.
HTML / Vue / SvelteCSS / SCSS / Sass / LessMarkdown / MDXreStructuredTextAsciiDoc
What the agent actually gets
Six real task shapes from local dogfooding. The output stays bounded, exposes uncertainty, and carries the same graph evidence from orientation through verification.
- Graphmodules, symbols, routes
- Contextexact source workset
- Impactruntime and type radius
- RatchetsHealth, clones, architecture
- VerdictPASS, BLOCKED or incomplete evidence
Unfamiliar backend
From 1,076 files to one request flow
› Where does attack mitigation start?
module_map → product territories
list_endpoints → 462 observed routes
trace_endpoint → mount → controller
→ service → task/messaging
Result: one bounded call path with
call-site excerpts, not a repository dump.Cross-repository API
Prove backend use outside its own graph
› Can this handler be removed?
trace_api_contract
3 registered repository graphs
163 backend endpoints observed
267 client callsites joined
NOT_DEAD_EXTERNAL_USE
dynamic URLs remain POSSIBLE / unproven
Branch review
Classify a method change before editing blind
› What breaks in this BranchPilot diff?
change_impact
removed methods / signatures separated
additive exports kept low-risk
98 impacted nodes observed
runtime vs type-only radius retained
Then: context_bundle → edit →
verified_change phase=verify
Health and repetition
Turn a large repository into a review queue
› Show actionable debt, not boilerplate.
run_audit
missing direct dependency: mongodb
runtime cycle evidence + lockfile drift
find_duplicates
repeated nudge() family observed
router boilerplate suppressed by default
Every item stays review-required;
no auto-delete or cosmetic green score.
Event-driven flow
Trace a listener without forcing it through REST
› Who produces and consumes this event?
query_graph
seed_symbols=["handleAttackEvents"]
relation_filter=["calls","references"]
flow_direction="both"
context_bundle → production callers first
Exact seeds keep tests and fuzzy config
matches out of the bounded flow.
Architecture bootstrap
Review the target before making it policy
› Preserve this architecture from now on.
get_architecture_contract action=preview
adaptive source roots + candidate rules
observed directions: NOT ENFORCED
exact content + hash + one-time token
action=approve confirm_token=…
Creates only a missing local contract;
never overwrites active policy.
Release proof at the boundary we can reproduce.
The 2.0.2 engine was exercised against its own repository: 192 files became 1,531 nodes and 7,287 typed edges. Three clean graph builds establish the basic latency range; an unchanged refresh, literal search, and 1,000 hot graph_stats calls cover the short-load path. The installed Core 1.1.2 package then passed the same bounded MCP check.
73.21 msmedian full graph build
7.436 msunchanged refresh
136.83 calls/sinstalled Core short-load rate, 0 failures
87.71%Rust line coverage release gate
| Basic check | Result | Scope |
|---|
| Full graph build | 62.80 / 73.21 / 91.29 ms | minimum / median / maximum, 3 runs |
| Unchanged refresh | 7.436 ms | same repository revision |
| Literal search | 5.504 ms | native engine operation |
graph_stats | 0.661 ms mean | 1,000 hot calls |
| Measured coverage | 87.71% lines / 80.57% functions / 85.30% regions | Rust release gate |
| Installed Core initialize | 405.770 ms | pack, isolated install, native MCP |
Installed Core tools/list | 0.790 ms | 39 read-only MCP tools |
Installed Core first graph_stats | 54.880 ms | first bounded MCP call |
Installed Core hot graph_stats | 136.83 calls/s · p50 7.610 / p95 10.180 / p99 12.230 / max 48.360 ms | 1,000 calls, 0 failures |
Measured July 30, 2026 with the native 2.0.2 engine executable. This is deliberately a basic release verification plus short load, not a claim about every repository, machine, or workload. Methodology and reproducible evidence remain versioned with the engine; installed-package evidence remains with Core.
Intelligence that grows with the software.
The long-term direction is an evidence substrate for increasingly capable agents: a repository becomes a living model of code, intent, decisions, runtime signals, and verified outcomes. Models may change; durable evidence, explicit uncertainty, and human-controlled trust boundaries remain.
NOW · NATIVE · MITCore 1.10.0
The native MCP product: 44 network-free, source-read-only tools spanning repository graphs, impact, APIs, architecture, Git, search, semantics and memory. Install the same adapter from Cargo or npm.
NOW · SEARCH EVIDENCE · MITSEO 0.6.2
Fifteen MCP tools and a CLI over a revision-bound Search Evidence Graph. Audit the live site, name the producer, keep missing evidence unmeasured. Product · npm.
NOW · ENGINE · MITRust engine 2.9.0
The protocol-independent library beneath Core: 44 bounded operations across 24 repository surfaces, with no MCP server hidden in the engine. Source · crates.io.
NOW · WRITE LAYER · MITRefactor 1.0.11
Eleven evidence-backed refactoring methods, a measured rename-only profile, write-gated crash-recoverable apply and drift-checked rollback. Source · npm.
NOW · NETWORK LAYER · MITOnline 0.3.2
Seven explicit network methods for advisory refresh, malware review, architecture contracts and preview-confirmed source-free sync—without silently bundling Core or Refactor. Source · npm.
ACCESS-CONTROLLED CLOUDManaged workbench
app.weavatrix.com is the managed workbench for source-free evidence, revision history and target-architecture review. Tenant onboarding is controlled while the multi-tenant service evolves.
LICENSED SELF-HOSTEDWeavatrix Enterprise
The same source-free contract can target a customer-hosted deployment with its own authorization, workers and repositories. Deployment and update rights are supplied by written agreement.
RESEARCHHeterogeneous intelligence
weavatrix-hetero explores how different analyzers, models, evidence types, and compute substrates can cooperate without flattening their strengths into one opaque score. Research direction.