Before your AI edits code,give it a map.

Del quechua ñawpa: «lo que va adelante».

Connect Ñaupa MCP to your agent to find dependencies, understand a repository and explore what a change could affect. The index is built on your computer. No Theus subscription required.

  • Free · MIT
  • No account
  • 158 AST languages
  • 19 MCP tools
Example using CLI measurements, not a live run
$ curl -fsSL https://theus.pe/naupa.sh | bash -s -- --ui --skip-config[ñaupa] verificando SHA-256… ok[ñaupa] instalado en ~/.local/bin/naupa$ naupa cli index_repository '{"repo_path":"."}'$ naupa cli blast_radius '{"project":"ID_DEL_PROYECTO"}'

Three questions.A project you understand better.

Try them on your repository. These are instructions for your agent, not prewritten results.

Before changing a function

Explore dependencies and tests related to your change, with the limits of static analysis in view.

Use Ñaupa and blast_radius to analyze my git diff. Show affected functions, routes and candidate tests with file and line references. Explain analysis limitations. Do not edit code or run tests.

Copy query

When joining a project

Find its modules, entry points and connections without starting by reading every file.

Use Ñaupa to check this repository's index and query get_architecture. Explain modules and entry points with code references. If the index is missing, ask before creating it. Do not edit files.

Copy query

When you do not know where to look

Find a feature by what it does and follow calls to its implementation.

Use Ñaupa search_graph to find where sessions are validated. Then use trace_path to show how execution reaches that validation. Cite files and lines, distinguishing findings from unresolved links. Do not edit code.

Copy query

Your agent, with contextfrom your own code.

You need a client that supports local MCP servers over stdio. Ñaupa does not require a Theus account; your agent may have its own requirements and costs.

  1. Install the engine

    On macOS or Linux, the command below installs the UI variant without changing other agents' configuration.

  2. Connect only the agent you choose

    Add a local MCP server named naupa, enter the absolute path to the executable and leave arguments empty. The guide includes JSON and TOML formats.

  3. Open a repository and ask your first question

    Restart your agent, check that Ñaupa is connected and ask it to index your project path. Then try one of the questions on this page.

macOS and Linux · engine with UI

curl -fsSL https://theus.pe/naupa.sh | bash -s -- --ui --skip-config
Install only Ñaupa on Windows

First query for your agent

Use Ñaupa to index the repository at ABSOLUTE_PROJECT_PATH and query get_architecture. Explain its modules and entry points with code references. Do not edit files.

Replace ABSOLUTE_PROJECT_PATH with your real project directory before sending.

Copy query
Open MCP connection guide

The index is built locally. Code snippets returned to your agent may be sent to that agent's provider: review its privacy settings.

Already using Theus CLI? See its automatic integrationSee the 19 tools and their limits

The City

Your repository, like a cityyou can walk through.

Engraving: a city of towers and walkways seen from above, each building a module of the repository
  • 29 738nodos
  • 120 000+aristas

Every building is a real module and grows floor by floor with the symbols that live inside it. A real recording of the City over the CLI's own repository. Indexing runs entirely on your machine: it does not upload your code anywhere.

Meaning-based search

The same phrase grep cannot find.

Search for «pay the top-up with yape». Nobody wrote that literal phrase in the code — but the graph knows where the idea lives.

grep -rn "pagar la recarga con yape"

0

Results · The literal phrase does not exist

search_graph · query: "pagar la recarga con yape"

5

Places across 2 repositories · With file and line

  • MIT licence
  • Binary verified by SHA-256
  • The index never leaves your disk
  • Works with or without a subscription

Free. MIT.No account.

$ curl -fsSL https://theus.pe/naupa.sh | bash -s -- --ui --skip-config¿Lo quieres para tu equipo? Escríbenos →