Semantic code knowledge graph for Kiro: fewer tool calls, instant symbol lookups, 100% local.
When Kiro works on complex tasks it reads files, runs grep, and globs your codebase. Every one of those is a tool call that burns context and slows things down.
One kirograph_context call replaces a cascade of file reads, greps, and glob searches. Kiro gets symbol relationships, call graphs, and type hierarchies in a single round trip.
Everything is stored in a local SQLite database at .kirograph/kirograph.db. No telemetry, no external services, no API keys. Your code stays on your machine.
Kiro hooks mark the index dirty on every save and flush changes when the agent stops. No background watcher process; changes batch efficiently with no overhead during editing.
A complete semantic index with 24 node kinds, 13 edge types, and three indexing layers.
Context building, symbol search, call graphs, type hierarchies, impact analysis, dead code, circular deps, architecture, coupling metrics, snapshots, and more, all auto-approved in Kiro.
Every capability available from the terminal: kirograph index, sync, query, context, files, affected, path, hotspots, snapshot, export, and more.
Four IDE hooks keep the index fresh automatically: fileEdited, fileCreated, fileDeleted, and agentStop. Changes batch efficiently, no watcher process needed.
Auto-detects packages and architectural layers (api, service, data, ui, shared). Computes coupling metrics (Ca, Ce, instability) across your entire package graph.
Opt-in embedding-based search with configurable models and seven pluggable engines: cosine, sqlite-vec, orama, pglite, lancedb, qdrant, typesense.
Choose from curated models: nomic-embed-text-v1.5 (default, 768d), embeddinggemma-300m (multilingual), all-MiniLM-L6-v2 (lightweight), bge-base-en-v1.5, or any custom HuggingFace model.
Auto-detects React, Next.js, Express, Django, Flask, FastAPI, Rails, Spring, ASP.NET, Phoenix, Laravel, SwiftUI, and more. Enriches the graph with routes, components, and lifecycle methods.
Interactive graph dashboard with search, two-click path finding, cluster view, minimap, heat map, and analytics charts. Run kirograph export to generate it.
Compresses the agent's communication style to cut token usage on responses. Four levels: lite, full, ultra. Injected via steering file, no extra tool calls.
Save lightweight graph snapshots before refactors. Diff the current graph against any snapshot to see added/removed symbols and edges, available as both CLI and MCP tool.
Find the most-connected symbols and non-obvious cross-file coupling. Useful for identifying load-bearing code and unexpected dependencies before making changes.
KiroGraph parses your codebase with tree-sitter, stores everything in SQLite, and exposes it through MCP tools and CLI commands.
Kiro hooks mark the index dirty on every file save or create, then flush on agent idle, batching changes efficiently with no overhead during active editing.
Enable embeddings for natural-language search. Choose the engine that fits your project size and constraints; all fall back gracefully if deps are missing.
| Engine | Search type | Native deps? | Best for |
|---|---|---|---|
cosine (default) | Exact cosine, linear scan | None | Small/medium projects, zero setup |
sqlite-vec | ANN, sub-linear | Yes | Large codebases, fast ANN |
orama | Hybrid (full-text + vector) | No (pure JS) | Best result quality, no native deps |
pglite | Hybrid, exact (WASM pgvector) | No (WASM) | Exact results, PostgreSQL semantics |
lancedb | ANN, sub-linear | No (pure JS) | Fast ANN, no native compilation |
qdrant | ANN (HNSW) | Yes (binary) | Full Qdrant features, built-in dashboard |
typesense | ANN (HNSW) | Yes (auto-downloaded) | Fast ANN, auto-downloaded binary |
Configure via kirograph install (interactive menu) or set semanticEngine in .kirograph/config.json. Each engine owns its embedding store exclusively. Switch engines without data conflicts.
All languages use WASM-compiled tree-sitter grammars. Frameworks are auto-detected and enrich the graph with routes, components, and lifecycle methods.