Navegador

navegador / docs / index.md
Source Blame History 165 lines
5be4bd1… lmata 1 # Navegador <small>v0.7</small>
5e4b8e4… anonymous 2
ce0374a… lmata 3 **The project knowledge graph for AI coding agents.**
5e4b8e4… anonymous 4
ce0374a… lmata 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.
5e4b8e4… anonymous 6
5e4b8e4… anonymous 7 > *navegador* — Spanish for *navigator / sailor*. It helps agents navigate your code.
89816aa… lmata 8 >
89816aa… lmata 9 > **Current version: 0.7.0**
ce0374a… lmata 10
ce0374a… lmata 11 ---
ce0374a… lmata 12
ce0374a… lmata 13 ## Two layers, one graph
ce0374a… lmata 14
ce0374a… lmata 15 ```
ce0374a… lmata 16 ┌─────────────────────────────────────────────────────────────────┐
ce0374a… lmata 17 │ KNOWLEDGE LAYER │
ce0374a… lmata 18 │ Concepts · Rules · Decisions · WikiPages · People · Domains │
ce0374a… lmata 19 │ │
ce0374a… lmata 20 │ ↕ GOVERNS / IMPLEMENTS / DOCUMENTS / ANNOTATES │
ce0374a… lmata 21 │ │
ce0374a… lmata 22 │ CODE LAYER │
ce0374a… lmata 23 │ Repository · File · Module · Class · Function · Method │
ce0374a… lmata 24 │ Variable · Import · Decorator · (call graphs, hierarchies) │
ce0374a… lmata 25 └─────────────────────────────────────────────────────────────────┘
ce0374a… lmata 26 stored in FalkorDB (SQLite local / Redis prod)
ce0374a… lmata 27 ```
ce0374a… lmata 28
89816aa… lmata 29 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).
5e4b8e4… anonymous 30
5e4b8e4… anonymous 31 ---
5e4b8e4… anonymous 32
5e4b8e4… anonymous 33 ## Quick start
5e4b8e4… anonymous 34
5e4b8e4… anonymous 35 ```bash
ce0374a… lmata 36 pip install navegador # Python 3.12+ required
ce0374a… lmata 37 navegador ingest ./my-repo # parse + index the codebase
ce0374a… lmata 38 navegador explain AuthService # what is this thing?
ce0374a… lmata 39 navegador search "rate limit" --all # search code + knowledge together
89816aa… lmata 40 ```
89816aa… lmata 41
89816aa… lmata 42 Or use the Python SDK:
89816aa… lmata 43
89816aa… lmata 44 ```python
89816aa… lmata 45 from navegador import Navegador
89816aa… lmata 46
89816aa… lmata 47 nav = Navegador(".navegador/navegador.db")
89816aa… lmata 48 nav.ingest("./my-repo")
89816aa… lmata 49 bundle = nav.explain("AuthService")
89816aa… lmata 50 print(bundle.to_markdown())
5e4b8e4… anonymous 51 ```
ce0374a… lmata 52
ce0374a… lmata 53 ---
ce0374a… lmata 54
ce0374a… lmata 55 ## What goes in the graph
ce0374a… lmata 56
ce0374a… lmata 57 | Layer | Node type | Populated by |
ce0374a… lmata 58 |---|---|---|
ce0374a… lmata 59 | Code | Repository, File, Module | `navegador ingest` |
ce0374a… lmata 60 | Code | Class, Function, Method | `navegador ingest` (tree-sitter AST) |
ce0374a… lmata 61 | Code | Decorator, Import, Variable | `navegador ingest` |
ce0374a… lmata 62 | Code | CALLS / INHERITS edges | `navegador ingest` (call graph analysis) |
ce0374a… lmata 63 | Knowledge | Concept, Domain | `navegador add concept` / `add domain` |
ce0374a… lmata 64 | Knowledge | Rule | `navegador add rule` |
ce0374a… lmata 65 | Knowledge | Decision | `navegador add decision` |
ce0374a… lmata 66 | Knowledge | Person | `navegador add person` |
ce0374a… lmata 67 | Knowledge | WikiPage | `navegador wiki ingest` |
ce0374a… lmata 68 | Knowledge | (any) | `navegador planopticon ingest` |
ce0374a… lmata 69 | Cross-layer | ANNOTATES, GOVERNS, IMPLEMENTS | `navegador annotate` |
89816aa… lmata 70 | Analysis | TESTS, COUPLED_WITH edges | `navegador testmap`, `navegador cycles` |
ce0374a… lmata 71
ce0374a… lmata 72 ---
ce0374a… lmata 73
ce0374a… lmata 74 ## Agent integration
ce0374a… lmata 75
ce0374a… lmata 76 === "CLI"
ce0374a… lmata 77
ce0374a… lmata 78 The simplest integration: call `navegador explain` or `navegador context` from any shell script or agent tool definition.
ce0374a… lmata 79
ce0374a… lmata 80 ```bash
ce0374a… lmata 81 # get context for the file the agent just edited
ce0374a… lmata 82 navegador context src/auth/service.py --format json
ce0374a… lmata 83
ce0374a… lmata 84 # look up a function before editing it
ce0374a… lmata 85 navegador function validate_token --depth 2 --format json
ce0374a… lmata 86
ce0374a… lmata 87 # find everything annotated with a business concept
ce0374a… lmata 88 navegador concept PaymentProcessing --format json
ce0374a… lmata 89 ```
ce0374a… lmata 90
ce0374a… lmata 91 === "MCP"
ce0374a… lmata 92
ce0374a… lmata 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.
ce0374a… lmata 94
ce0374a… lmata 95 ```json
ce0374a… lmata 96 {
ce0374a… lmata 97 "mcpServers": {
ce0374a… lmata 98 "navegador": {
ce0374a… lmata 99 "command": "navegador",
ce0374a… lmata 100 "args": ["mcp"]
ce0374a… lmata 101 }
ce0374a… lmata 102 }
ce0374a… lmata 103 }
ce0374a… lmata 104 ```
ce0374a… lmata 105
89816aa… lmata 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.
ce0374a… lmata 107
ce0374a… lmata 108 === "Bootstrap"
ce0374a… lmata 109
ce0374a… lmata 110 One command to install navegador, ingest a repo, and wire the agent hook for your preferred AI coding assistant.
ce0374a… lmata 111
ce0374a… lmata 112 ```bash
ce0374a… lmata 113 ./bootstrap.sh --repo owner/repo --wiki --agent claude
ce0374a… lmata 114 ```
ce0374a… lmata 115
ce0374a… lmata 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.
89816aa… lmata 117
89816aa… lmata 118 === "Editor integration"
89816aa… lmata 119
89816aa… lmata 120 Wire navegador into your editor with one command:
89816aa… lmata 121
89816aa… lmata 122 ```bash
89816aa… lmata 123 navegador editor setup claude-code
89816aa… lmata 124 navegador editor setup cursor
89816aa… lmata 125 navegador editor setup codex
89816aa… lmata 126 navegador editor setup windsurf
89816aa… lmata 127 ```
89816aa… lmata 128
89816aa… lmata 129 === "CI/CD"
89816aa… lmata 130
89816aa… lmata 131 Run navegador in CI pipelines for automated context checks:
89816aa… lmata 132
89816aa… lmata 133 ```bash
89816aa… lmata 134 navegador ci ingest
89816aa… lmata 135 navegador ci stats
89816aa… lmata 136 navegador ci check
89816aa… lmata 137 ```
89816aa… lmata 138
89816aa… lmata 139 ---
89816aa… lmata 140
89816aa… lmata 141 ## What's new in 0.7.0
89816aa… lmata 142
89816aa… lmata 143 | Feature | Command / API |
89816aa… lmata 144 |---|---|
89816aa… lmata 145 | **13 languages** (added Kotlin, C#, PHP, Ruby, Swift, C, C++) | `pip install "navegador[languages]"` |
89816aa… lmata 146 | **Python SDK** | `from navegador import Navegador` |
89816aa… lmata 147 | **Incremental ingestion** | `navegador ingest --incremental`, `--watch` |
89816aa… lmata 148 | **Schema migrations** | `navegador migrate` |
89816aa… lmata 149 | **Export / import** | `navegador export`, `navegador import` (JSONL) |
89816aa… lmata 150 | **Editor integrations** | `navegador editor setup <editor>` |
89816aa… lmata 151 | **Analysis commands** | `navegador diff`, `navegador churn`, `navegador impact`, `navegador trace`, `navegador deadcode`, `navegador cycles`, `navegador testmap` |
89816aa… lmata 152 | **Multi-repo** | `navegador repo add/list/ingest-all/search` |
89816aa… lmata 153 | **Semantic search** | `navegador semantic-search`, `navegador ask` |
89816aa… lmata 154 | **Framework enrichment** | Django, FastAPI, React, Rails, Spring Boot, Laravel, and more |
89816aa… lmata 155 | **Monorepo support** | Turborepo, Nx, Yarn, pnpm, Cargo, Go workspaces |
89816aa… lmata 156 | **Cluster mode** | Shared Redis graph, pub/sub, task queue, sessions |
89816aa… lmata 157 | **11 MCP tools** (was 7) | `get_rationale`, `find_owners`, `search_knowledge`, `blast_radius` added |
89816aa… lmata 158 | **Sensitive content redaction** | `navegador ingest --redact` |
89816aa… lmata 159 | **Shell completions** | `navegador completions bash/zsh/fish` |
5e4b8e4… anonymous 160
5e4b8e4… anonymous 161 ---
5e4b8e4… anonymous 162
5e4b8e4… anonymous 163 ## License
5e4b8e4… anonymous 164
ce0374a… lmata 165 Navegador is open source under the [MIT License](https://github.com/ConflictHQ/navegador/blob/main/LICENSE). Copyright 2026 CONFLICT LLC.

Keyboard Shortcuts

Open search /
Next entry (timeline) j
Previous entry (timeline) k
Open focused entry Enter
Show this help ?
Toggle theme Top nav button