# @monoes/monograph
[](https://www.npmjs.com/package/@monoes/monograph)
[](https://github.com/monoes/monomind/blob/main/LICENSE)
[](https://nodejs.org)
**Code intelligence as a graph** — tree-sitter parses your codebase into a SQLite-backed knowledge graph of files, functions, classes, imports, and call relationships. Query blast radius, find callers, and navigate architecture without grep.
> Part of the [Monomind](https://github.com/monoes/monomind) ecosystem.
## Install
```bash
npm install @monoes/monograph
```
## What it does
Monograph walks your source tree with [tree-sitter](https://tree-sitter.github.io/tree-sitter/), extracts symbols and their relationships, and stores them in a SQLite database. The result is a queryable graph where:
- **Nodes** are files, functions, classes, methods, and exports
- **Edges** are imports, calls, extends, and contains relationships
## CLI usage
```bash
# Build the graph for the current project
monomind monograph build
# Search the knowledge graph (BM25, semantic, or hybrid)
monomind monograph search -q "authentication flow"
# Show graph statistics
monomind monograph stats
# Watch for changes and rebuild incrementally
monomind monograph watch
# Start the LSP server for editor integration
monomind monograph lsp
# Build a document knowledge graph from docs & PDFs (separate from the code graph above)
monomind monograph wiki
```
> `impact` (blast radius), `god-nodes` (high-centrality files), and freshness/staleness checks have no CLI subcommand — they're MCP-tool-only (`monograph_impact`, `monograph_god_nodes`, `monograph_health`, `monograph_staleness`), see [MCP tools](#mcp-tools) below. `stats` above reports graph size, not freshness — don't confuse the two.
## Programmatic usage
```typescript
import { buildAsync, openDb, queryGraph, getMonographImpact } from '@monoes/monograph';
await buildAsync(process.cwd());
const db = openDb('.monomind/monograph.db');
const results = queryGraph(db, { query: 'authenticate' });
const impact = getMonographImpact(db, { name: 'login', filePath: 'src/auth/login.ts' });
```
## MCP tools
When used via Monomind's MCP server, monograph exposes 19 tools by default (+27 advanced via `MONOGRAPH_MCP_ADVANCED=1`):
| Tool | Purpose |
|---|---|
| `monograph_suggest` | Start every task — ranked relevant files |
| `monograph_query` | BM25 keyword search with PPR graph reranking |
| `monograph_impact` | Blast radius analysis (upstream + downstream) |
| `monograph_god_nodes` | High-centrality internal files |
| `monograph_context` | 360° view of a file |
| `monograph_augment` | Graph-RAG context retrieval |
| `monograph_dead_code` | Dead exports, orphan files, stale dist |
| `monograph_detect_changes` | Map git diff to affected graph nodes |
| `monograph_route_map` | List HTTP routes with handlers |
| `monograph_watch` | Start incremental file watcher — rebuilds on file changes |
| `monograph_watch_stop` | Stop the incremental file watcher |
| `monograph_health` | Manual, on-demand staleness check |
| `monograph_staleness` | Staleness check — auto-triggers a background rebuild if >3 commits behind HEAD |
## Supported languages & Parsers
Monograph utilizes a dual-tier parsing strategy for extracting code structure and symbols.
> **This section is the authoritative source for Monograph's language/grammar counts.**
> Other docs in this repo should link here instead of restating the numbers.
1. **Tree-sitter AST Parsers — 14 grammar modules, 25 supported extensions**:
- **Grammar modules** (one `LanguageConfig` + tree-sitter package each, [`src/parsers/`](packages/@monomind/monograph/src/parsers/)): `c`, `cpp`, `csharp`, `dart`, `go`, `java`, `kotlin`, `php`, `python`, `ruby`, `rust`, `swift`, `typescript`, `vue` — 14 total. (`typescript` also covers JavaScript; there is no separate JS grammar.)
- **Extensions**: `.ts`, `.tsx`, `.js`, `.jsx`, `.mjs`, `.cjs`, `.py`, `.go`, `.rs`, `.java`, `.c`, `.h`, `.cpp`, `.cc`, `.cxx`, `.hpp`, `.hxx`, `.cs`, `.rb`, `.swift`, `.php`, `.vue`, `.kt`, `.kts`, `.dart` — 25 total, mapped onto the 14 grammar modules above.
- **Grammar Loader**: Dynamically loads and caches Tree-sitter grammars per extension via `getParser(ext)` ([`loader.ts:64-83`](packages/@monomind/monograph/src/parsers/loader.ts#L64-L83)). Supports `