Navegador
Navegador
Your codebase + everything your team knows about it — in one queryable graph.
Navegador parses your source code into a property graph and layers your team's knowledge on top: decisions, concepts, rules, people, wiki pages, and meeting outputs. AI coding agents get structured, precise context instead of raw file dumps.
navegador — Spanish for navigator / sailor
Two layers, one graph
┌─────────────────────────────────────────────────────────────────┐
│ KNOWLEDGE LAYER │
│ Concepts · Rules · Decisions · WikiPages · People · Domains │
│ │
│ ↕ GOVERNS / IMPLEMENTS / DOCUMENTS / ANNOTATES │
│ │
│ CODE LAYER │
│ Repository · File · Module · Class · Function · Method │
│ Variable · Import · Decorator · (call graphs, hierarchies) │
└─────────────────────────────────────────────────────────────────┘
stored in FalkorDB (SQLite local · Redis prod)
The code layer is built automatically by ingesting source trees. The knowledge layer is populated by your team — manually, via wiki ingestion, or from PlanOpticon meeting analysis output.
Quick start
pip install navegador
# Ingest your repo
navegador ingest ./myrepo
# Load context for a file
navegador context src/auth.py
# Search across code + knowledge
navegador search "rate limit" --all
# Explain a symbol
navegador explain AuthService
# Check graph stats
navegador stats
MCP integration
Add to your Claude / Cursor / Gemini MCP config:
{
"mcpServers": {
"navegador": {
"command": "navegador",
"args": ["mcp", "--db", ".navegador/graph.db"]
}
}
}
Available MCP tools:
| Tool | Description |
|---|---|
ingest_repo |
Parse and load a repo into the graph |
load_file_context |
All symbols in a file + their relationships |
load_function_context |
What a function calls and what calls it |
load_class_context |
Class methods, inheritance, subclasses |
search_symbols |
Fuzzy search for functions/classes by name |
query_graph |
Raw Cypher passthrough (with security hardening) |
graph_stats |
Node and edge counts |
get_rationale |
Decision rationale, alternatives, and status |
find_owners |
People assigned to any node |
search_knowledge |
Search concepts, rules, decisions, wiki |
blast_radius |
Impact analysis — what's affected by a change |
Knowledge layer
Beyond code structure, navegador stores what your team knows:
# Record an architectural decision
navegador add decision "Use FalkorDB for graph storage" \
--rationale "Cypher queries, SQLite-backed zero-infra mode"
# Define a business concept and link it to code
navegador add concept PaymentProcessing
navegador annotate PaymentProcessing --function process_charge
# Add a rule
navegador add rule "All writes must go through the service layer"
# Ingest your GitHub wiki
navegador wiki ingest --repo myorg/myrepo
# Import PlanOpticon meeting analysis
navegador planopticon ingest ./meeting-output/
Graph schema
Code nodes: Repository · File · Module · Class · Function · Method · Variable · Import · Decorator
Knowledge nodes: Concept · Rule · Decision · Person · Domain · WikiPage
Edges: CONTAINS · DEFINES · IMPORTS · CALLS · INHERITS · REFERENCES · DEPENDS_ON · GOVERNS · IMPLEMENTS · DOCUMENTS · ANNOTATES
Storage
| Mode | Backend | When to use |
|---|---|---|
| Default | falkordblite (SQLite) |
Local dev, zero infrastructure |
| Production | Redis + FalkorDB module | Shared deployments, agent swarms |
from navegador.graph import GraphStore
store = GraphStore.sqlite(".navegador/graph.db") # default
store = GraphStore.redis("redis://localhost:6379") # production
Language support
| Language | Status |
|---|---|
| Python | ✅ |
| TypeScript / JavaScript | ✅ |
| Go | ✅ |
| Rust | ✅ |
| Java | ✅ |
| Kotlin | ✅ |
| C# | ✅ |
| PHP | ✅ |
| Ruby | ✅ |
| Swift | ✅ |
| C / C++ | ✅ |
Framework enrichment
After ingesting code, navegador can promote generic AST nodes to framework-specific semantic types:
navegador enrich # auto-detect frameworks
navegador enrich --framework django # target a specific framework
Supported frameworks: Django, FastAPI, React / Next.js, Express.js, React Native, Rails, Spring Boot, Laravel
Structural analysis
navegador impact AuthService --depth 3 # blast radius
navegador trace handle_request # execution flow from entry point
navegador deadcode # unreachable functions/classes
navegador cycles # circular dependencies
navegador testmap # link tests to production code
navegador diff # map uncommitted changes to graph
navegador churn . # behavioural coupling from git history
Intelligence layer
navegador semantic-search "authentication flow" # embedding-based search
navegador communities # detect code communities
navegador ask "what calls the payment service?" # natural language queries
navegador docs src/auth.py # generate documentation
Requires an LLM provider: pip install navegador[llm]
Python SDK
from navegador import Navegador
nav = Navegador.sqlite(".navegador/graph.db")
nav.ingest("./myrepo")
nav.add_concept("Payment", description="Payment processing", domain="billing")
results = nav.search("auth")
bundle = nav.explain("AuthService")
owners = nav.find_owners("AuthService")
Cluster mode (agent swarms)
For multi-agent setups sharing a Redis-backed graph:
navegador init --redis redis://host:6379 --cluster
Features: shared graph with local snapshots, pub/sub notifications, task queues, distributed locking, session namespacing, checkpoints, agent messaging, observability dashboard.
Additional integrations
navegador codeowners ./myrepo # parse CODEOWNERS → ownership graph
navegador adr ingest docs/decisions/ # Architecture Decision Records
navegador api ingest openapi.yaml # OpenAPI / GraphQL schemas
navegador deps ingest package.json # external dependency tracking
navegador pm ingest --github org/repo # GitHub issues → knowledge graph
navegador editor setup claude-code # generate MCP config for editors
navegador explore # browser-based graph visualization
Installation
PyPI
pip install navegador
Standalone binaries
No Python required — download prebuilt binaries from GitHub Releases:
| Platform | Binary |
|---|---|
| macOS (Apple Silicon) | navegador-macos-arm64 |
| macOS (Intel) | navegador-macos-x86_64 |
| Linux | navegador-linux-x86_64 |
| Windows | navegador-windows-x86_64.exe |
From source
git clone https://github.com/ConflictHQ/navegador.git
cd navegador
pip install -e ".[dev]"
pytest
Contributing
See CONTRIBUTING.md. Bug reports and feature requests welcome via GitHub Issues.
License
MIT — CONFLICT