Understand the code beneath the surface.

CodeGraphy is a local, interactive Relationship Graph for files, symbols, packages, and their connections, so you can see how a workspace actually fits together.

Install in VS CodeExplore the source
$ npm i -g @codegraphy-dev/core
View examples

From the whole system to one exact relationship.

Across four depths, CodeGraphy keeps the map visible while you change the question. Each layer uses the same Core-owned graph, whether you explore in VS Code or query from the terminal.

Map the whole workspace.

Index files, folders, packages, and symbols into one local Relationship Graph. Start wide, then follow the connections that matter.

One graph cache · local source · no upload
VS Code · CodeGraphy Workspace01

Move through relationships.

Pan, zoom, focus, and expand the graph as a living system. Physics reveals clusters and paths that a folder tree cannot show.

WebGPU renderer · WebAssembly physics
VS Code · CodeGraphy Workspace02

Ask a smaller question.

Search, filter, and set Graph Scope without losing the surrounding system. Keep the context you need and quiet the rest.

Search · filters · persistent scope
VS Code · CodeGraphy Workspace03

Teach the graph new meaning.

Plugins add framework, engine, document, and visual semantics through typed contracts while Core keeps one consistent graph model.

Plugin API v3 · package-owned semanticsExplore the Plugin API
VS Code · CodeGraphy Workspace04

Give your agent a map before it starts walking.

The CodeGraphy Agent Skill teaches shell-capable coding agents to index first, ask bounded Graph Query questions, and open source only when the graph says it matters.

Read the Agent SkillExplore the Core CLI
  1. 01

    Build the local map

    Install Core and index the current workspace into the same Graph Cache used by VS Code.

    npm i -g @codegraphy-dev/core
    codegraphy index
  2. 02

    Ask a bounded question

    Query dependencies, dependents, paths, or scoped symbols before opening source.

    codegraphy dependencies packages/core/src/cli/command.ts

A wide surface area, one consistent graph.

Core ships broad baseline language coverage. Plugins add deeper, ecosystem-specific meaning where syntax alone is not enough.

Start at the surface. Go as deep as you need.

The extension is the fastest way in. The CLI and Plugin API are there when your workflow needs more.

Install in VS CodeMarketplace

  1. 01

    See it in VS Code

    Install the extension, open a CodeGraphy Workspace, run Indexing, and explore the Relationship Graph beside your code.

    Install the extension

  2. 02

    Query it from the terminal

    Install @codegraphy-dev/core when you want headless Indexing, diagnostics, Graph Query, Graph Scope, and Filter commands.

    Read the CLI guide

  3. 03

    Teach it more

    Enable official Plugins or build a typed Plugin Package to add framework, engine, document, or language-specific graph meaning.

    Explore Plugins
Light filtering through deep blue water

See the relationships your folder tree cannot show.

$ npm i -g @codegraphy-dev/core
Install CodeGraphy