**The project knowledge graph for AI coding agents.**
4
5
Navegador builds and maintains a queryable graph of your software project — combining static code analysis with human-curated business knowledge — so that AI coding agents always have precise, structured context instead of raw file dumps.
6
7
> *navegador* — Spanish for *navigator / sailor*. It helps agents navigate your code.
The **code layer** is populated automatically by ingesting source trees. 13 languages are supported via tree-sitter (Python, TypeScript, JavaScript, Go, Rust, Java, Kotlin, C#, PHP, Ruby, Swift, C, C++). The **knowledge layer** is populated by manual curation (`navegador add`), GitHub wiki ingestion, and [Planopticon](guide/planopticon.md) output (meeting and video knowledge graphs).
30
31
---
32
33
## Quick start
34
35
```bash
36
pip install navegador # Python 3.12+ required
37
navegador ingest ./my-repo # parse + index the codebase
38
navegador explain AuthService # what is this thing?
navegador function validate_token --depth 2 --format json
86
87
# find everything annotated with a business concept
88
navegador concept PaymentProcessing --format json
89
```
90
91
=== "MCP"
92
93
Run navegador as a Model Context Protocol server. Configure it once in your agent settings and all navegador commands become callable tools with structured input/output.
94
95
```json
96
{
97
"mcpServers": {
98
"navegador": {
99
"command": "navegador",
100
"args": ["mcp"]
101
}
102
}
103
}
104
```
105
106
11 tools available. See [MCP Integration](guide/mcp-integration.md) for the full tool list and per-agent config snippets. Use `--read-only` mode to restrict agents to query-only access.
107
108
=== "Bootstrap"
109
110
One command to install navegador, ingest a repo, and wire the agent hook for your preferred AI coding assistant.
111
112
```bash
113
./bootstrap.sh --repo owner/repo --wiki --agent claude
114
```
115
116
Supports `--agent claude`, `--agent gemini`, and `--agent openai`. See [Agent Hooks](guide/agent-hooks.md) for what the hook does and how to configure it manually.
117
118
=== "Editor integration"
119
120
Wire navegador into your editor with one command:
121
122
```bash
123
navegador editor setup claude-code
124
navegador editor setup cursor
125
navegador editor setup codex
126
navegador editor setup windsurf
127
```
128
129
=== "CI/CD"
130
131
Run navegador in CI pipelines for automated context checks: