A live map of your codebase, for you and Claude Code.

Nebulosity indexes every import in your repo, so Claude Code can answer questions that span many files in one call. In tests, that made it up to 4.4× faster, and up to 3.7× faster* on Theia, a codebase Nebulosity was never adjusted for. Every answer was right.

Free and open source. Without an API key, none of your code leaves your machine.

In VS Code, Claude Code is asked which folders inside src/vs import src/vs/platform/terminal/common/terminal.ts. It answers in the terminal, and the Map above highlights the five folders that do, workbench, platform, sessions, server and code, while base and editor stay plain
Ask Claude Code a question, and it points at the answer on the Map.

See the same imports on the Map

One folder at a time, with lines for what imports what. Click any box to see what it uses and what uses it, or press Ctrl K to search.

The Map on VS Code's src/vs/platform folder: boxes for its folders with their file counts, the first of three pages
The live demo is the Map on VS Code's own repo, all 15,040 files, with nothing to install. Try the live demo

Tested against Claude Code on its own

The same questions, with and without Nebulosity, on three large TypeScript codebases: 378 runs, each checked against a reference answer.

How many times faster, by question

  • What could changing this file affect? VS Code and AFFiNE:4.3× Theia, measured later:3.7×
  • How does this entry point end up loading that file? VS Code and AFFiNE:4.4× Theia:3.2×
  • Which entry points end up loading this file? VS Code and AFFiNE:4.2× Theia:2.8×
  • Which files depend on this one, directly or not? VS Code and AFFiNE:2.3× Theia:2.0×
  • Is this file part of an import cycle? VS Code and AFFiNE:2.3× Theia:1.5×

In the main test, 42 of 42 answers to these questions were fully right with Nebulosity, and 29 of 42 alone.

Medians of 6 runs per setup on VS Code and AFFiNE together, 3 on Theia. The question types were grouped after the runs; simpler ones, like listing a file's direct importers, came out about even. Read the full evaluation

* Theia's 3.7×, for what a change could affect, was measured later (26 October 2026) with the same setup. 3 of 3 answers were fully right with Nebulosity, 0 of 3 alone.

Install

You'll need
  • Node 24 or later
  • git
  • Claude Code 2.1.300 or later

In your terminal

4 steps
  1. 1

    Install the package

    npm install -g nebulosity
  2. 2

    Index your repo

    From its root folder. Free.

    nebulosity index .
  3. 3

    Open the Map

    It keeps running, at localhost:3000.

    nebulosity map
  4. 4

    Connect Claude Code

    In a second terminal, same folder.

    nebulosity setup

If something seems off, nebulosity doctor says what's missing. Every command is in the guide.

In VS Code

2 steps, after the first two above
  1. 1

    Install the extension

    From the Marketplace, or in a terminal.

    code --install-extension andrewl746.nebulosity-vscode
  2. 2

    Open the Map

    It follows the file you have open.

    Command PaletteNebulosity: Show Map

Then ask Claude Code

4 examples
  • What could break if src/vs/base/common/event.ts changes?
  • How does main.ts end up loading terminal.ts?
  • Which entry points load this file?
  • Are there import cycles in src/vs/platform?

Seven languages

TypeScript, JavaScript, Python, Go, Java, C# and Rust.

AI summaries, optional

With an Anthropic API key, a summary of every file and folder for about $1 per 1,000 files. It sends your code to Anthropic, and asks before spending.