Skip to content
github.com/Kehl-io/nestweaver · MIT · v0.1.0

NestWeaver

Structured code intelligence for AI agents — precomputed answers, not raw files.

NestWeaver — a fierce geometric raptor built from graph nodes

Why NestWeaver exists

AI agents waste their context window. Ask an agent to fix a bug and it reads entire files — thousands of tokens of boilerplate and unrelated code — just to find the three functions that matter. The context window fills up before the agent even starts thinking.

NestWeaver solves this at the source. It builds a persistent code knowledge graph from your codebase — parsing every symbol, resolving every cross-file reference — then uses Personalized PageRank to rank which nodes are actually relevant to the task at hand. When an agent needs context, NestWeaver returns a precomputed subgraph sized to fit the token budget, not raw file contents. Agents get precise, ranked answers instead of entire files.

How it works

  1. Index

    Tree-sitter parses 16+ languages into a unified symbol graph. Every function, class, import, and type is a node; every reference is an edge.

  2. Query

    Cross-file symbol resolution with confidence scoring — NestWeaver knows not just where a symbol is defined, but how certain that link is.

  3. Context

    Personalized PageRank walks the graph from a task-relevant seed set and extracts the highest-value subgraph that fits your token budget.

  4. Connect

    17+ MCP tools expose the graph to any MCP-aware agent. Agents query by symbol, file, or natural language — no file reads needed.

Features

Graph Intelligence

  • Personalized PageRank for task-relevant context extraction
  • Cross-file symbol resolution with confidence scoring
  • Token-budget-aware subgraph extraction
  • Incremental graph updates — only reparse changed files
  • 17+ MCP tools for agent integration

Multi-Language

  • 16+ languages via Tree-sitter: Rust, TypeScript, Python, Go, Java, C/C++, and more
  • Unified symbol graph across all languages in a polyglot repo
  • Import and type resolution across language boundaries
  • Language-agnostic MCP API — one interface for everything
  • Extensible parser layer for adding new languages

Brain

  • Index Markdown and Obsidian vaults alongside code
  • Link documentation, ADRs, and RFCs to the code symbols they describe
  • Natural language queries over code + docs combined
  • Unified knowledge graph spanning code and prose
  • Supports Obsidian-style wikilinks and frontmatter

Platform

  • Single static Rust binary — no runtime, no dependencies
  • Web UI with interactive graph visualization
  • macOS, Linux, and Windows support
  • MIT licensed and fully open source
  • Install with a single cargo command

Get started

Run this in your terminal:

cargo install nestweaver

Requires Rust / Cargo. Builds and installs the NestWeaver binary to your Cargo bin path.

Status

v0.1.0

NestWeaver is early but functional. Contributions are welcome — see CONTRIBUTING.md for details on adding language parsers, MCP tools, and graph algorithms.