# astria

> Understand a codebase before you touch it
> 
> Version: 1.4.0

Astria 1.4.0 released documentation and dated blog articles. Start with the AI workflow and architecture. Blog measurements describe their stated versions and corpora; they are not current performance guarantees. Next documentation is separate and unreleased.

## Table of Contents

- [Introduction](https://nodesify.github.io/astria/docs/intro.md): astria turns any folder into a queryable knowledge graph — deterministic AST extraction in Rust, optional local embeddings, zero API keys.
- [AI workflow and evidence contract](https://nodesify.github.io/astria/docs/guides/ai-workflow.md): An explicit procedure for coding agents to orient, query, disambiguate, verify provenance, assess impact, and refresh Astria graphs.
- [Architecture](https://nodesify.github.io/astria/docs/explanation/architecture.md): Source-to-answer architecture, evidence classes, publication boundaries, retrieval, and the shared CLI/MCP query engine.
- [Benchmarks and evidence](https://nodesify.github.io/astria/docs/explanation/benchmarks.md): Measured token-reduction numbers, methodology, the head-to-head against the original Python Graphify, and the embedding experiment — all reproducible.
- [Retrieval validation (September–October 2026)](https://nodesify.github.io/astria/docs/explanation/retrieval-validation.md): Paired local retrieval measurements, symbol preservation and performance tradeoffs.
- [Getting started](https://nodesify.github.io/astria/docs/getting-started.md): Install @nodesify/astria, build your first knowledge graph, query it, and keep it fresh — in under five minutes.
- [Global graph (cross-repo)](https://nodesify.github.io/astria/docs/guides/global-graph.md): Merge many repo graphs into one queryable store at ~/.astria/global.db — shared symbols deduplicate, cross-repo calls resolve.
- [Install, upgrade and remove Astria](https://nodesify.github.io/astria/docs/guides/installation-lifecycle.md): Scoped setup, installation diagnostics, safe upgrades, backup and complete removal.
- [Agent integration](https://nodesify.github.io/astria/docs/guides/mcp-and-agents.md): Connect AI coding assistants to the graph — MCP server, skill-file installers for ten platforms, git hooks, and the editor-side hook-guard.
- [Memory and learning](https://nodesify.github.io/astria/docs/guides/memory-and-learning.md): Two feedback loops — automatic learned edges from query history, and curated Q/A memory via save-result and reflect.
- [Semantic enrichment](https://nodesify.github.io/astria/docs/guides/semantic-enrichment.md): Two optional semantic layers — local embeddings (no API key) and LLM enrichment — that add similar_to edges and concept nodes to the graph.
- [Wiki and exports](https://nodesify.github.io/astria/docs/guides/wiki-and-exports.md): Export the graph as a markdown wiki, Obsidian vault, HTML or SVG visualization, GraphML/JSON, Neo4j, or FalkorDB.
- [CLI reference](https://nodesify.github.io/astria/docs/reference/cli.md): Every astria command and flag — building, querying, exporting, memory, the cross-repo global graph, and assistant integration.
- [The .astria directory](https://nodesify.github.io/astria/docs/reference/directory-layout.md): Every file astria writes — the SQLite graph, exports, report, wiki, memory, reflections, transcripts, downloads, and the cross-repo global store.
- [Environment variables](https://nodesify.github.io/astria/docs/reference/env-vars.md): Every environment variable astria reads — LLM backends, embeddings, query logging, and hook-guard.
- [Graph model](https://nodesify.github.io/astria/docs/reference/graph-model.md): What the graph contains — node types, relation types, provenance (EXTRACTED / RESOLVED / INFERRED / SEMANTIC / AMBIGUOUS), confidence scores, hyper...
- [Language support](https://nodesify.github.io/astria/docs/reference/language-support.md): Registered languages, discovered extensions, and configured tree-sitter syntax extraction.
- [MCP tools reference](https://nodesify.github.io/astria/docs/reference/mcp-tools.md): The ten tools exposed by the astria MCP stdio server, with arguments, defaults, and example calls.
- [Troubleshooting](https://nodesify.github.io/astria/docs/reference/troubleshooting.md): Common issues — install problems, stale graphs, large-graph exports, and when a graph looks wrong.
- [nodesify-graphify 0.8.0: markdown wiki, Obsidian vault, local embeddings](https://nodesify.github.io/astria/blog/nodesify-graphify-0-8-0.md): **0.8.0** is out — `npm install -g @nodesify/graphify`. The graph now exports itself as documentation, adds a local semantic layer, and keeps learn...
- [astria 1.0.0: the graphify rebrand is complete](https://nodesify.github.io/astria/blog/astria-1-0-0.md): **1.0.0** is out — `npm install -g @nodesify/astria`. This is the release the project is fully astria: the binary, the npm package, the `.astria/` ...
- [astria 1.0.5: more complete code retrieval](https://nodesify.github.io/astria/blog/astria-1-0-5.md): **1.0.5** improves source-grounded retrieval and adds more ways to inspect a graph. Install or upgrade with `npm install -g @nodesify/astria`.
- [astria 1.0.6: documents you can actually search](https://nodesify.github.io/astria/blog/astria-1-0-6.md): **1.0.6** makes document and transcript corpora fully searchable for the first time, and brings three more MCP surfaces to the CLI. Install or upgr...
- [astria 1.0.7: a judge over the LLM, a viewer you can drill into](https://nodesify.github.io/astria/blog/astria-1-0-7.md): **1.0.7** adds a calibrated second opinion over every LLM extraction, rewrites the HTML export around drill-down, and tightens retrieval for prose ...
- [astria 1.0.10: MCP Registry namespace fix — the listing goes live](https://nodesify.github.io/astria/blog/astria-1-0-10.md): **1.0.10** is a one-fix release: it gets astria onto the official MCP Registry, which 1.0.9 reached npm for but could not list. Install or upgrade ...
- [astria 1.0.8: provenance you can see, agents that can't answer from the past](https://nodesify.github.io/astria/blog/astria-1-0-8.md): **1.0.8** makes the graph honest about what it knows and what it's guessing, tells you when it's stale, embeds with a code-aware model, and install...
- [astria 1.0.9: official MCP Registry, one-plugin Claude Code install, Homebrew, Smithery](https://nodesify.github.io/astria/blog/astria-1-0-9.md): **1.0.9** is the distribution release: astria is now listed where agents and package managers look for it — the official MCP Registry, the Claude C...
- [astria 1.0.11: the hardening release — safe migrations, an installer that can't wipe your configs](https://nodesify.github.io/astria/blog/astria-1-0-11.md): **1.0.11** lands everything from a full-repo audit: crash-proof database migrations, an installer that refuses to touch configs it can't parse, own...
- [astria 1.0.12: the trust release — proven graphs, gates that verify coverage, MCP over HTTP](https://nodesify.github.io/astria/blog/astria-1-0-12.md): **1.0.12** is the largest release since 1.0: MCP over HTTP with multi-project serving, first-class Azure/Bedrock/Kimi backends, 42 registered langu...
- [astria 1.1.0: evidence you can trust — no phantom files, gates that can actually fail](https://nodesify.github.io/astria/blog/astria-1-1-0.md): **1.1.0** fixes a class of quiet dishonesty in the graph. A node that exists *because no file defined the name* was borrowing whichever file happen...
- [astria 1.1.1: packaging and toolchain maintenance](https://nodesify.github.io/astria/blog/astria-1-1-1.md): **1.1.1** is a maintenance release with no user-facing behavior changes. It updates the native-module packaging toolchain to NAPI CLI v3, adopts Ty...
- [astria 1.2.0: behavior queries and quiet indexing](https://nodesify.github.io/astria/blog/astria-1-2-0.md): **1.2.0** ranks callable declarations ahead of vocabulary-sharing prose for behavior questions and removes automatic token-size benchmark output fr...
- [astria 1.3.0: typed calls and project-aware imports](https://nodesify.github.io/astria/blog/astria-1-3-0.md): **1.3.0** adds TypeScript receiver resolution through declared types and inherited members, interface dispatch relationships, and project-aware imp...
- [astria 1.4.0: scoped resolution and explicit uncertainty](https://nodesify.github.io/astria/blog/astria-1-4-0.md): **1.4.0** improves source resolution, reports ambiguous query seeds, and keeps graph refreshes complete across merges. It also adds declaration cov...
- [From source files to an agent answer: Astria's evidence pipeline](https://nodesify.github.io/astria/blog/astria-source-to-answer.md): An agent asking who calls `save` needs more than a plausible name match. It needs the intended declaration, a source location, the evidence behind ...