Skip to content
| Marketplace
Sign in
Visual Studio Code>Programming Languages>classScanner: C++ Class DiagramsNew to Visual Studio Code? Get it now.
classScanner: C++ Class Diagrams

classScanner: C++ Class Diagrams

jcd

|
3 installs
| (0) | Free
Interactive class diagrams of C++ code, smooth beyond 1000 classes. Scan a folder, explore the relations, export for docs or for an LLM.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

classScanner: C++ Class Diagrams

See the architecture of a C++ code base in seconds. Point classScanner at a folder and get an interactive class diagram that stays smooth with more than a thousand classes. No compiler, no build configuration, nothing to set up.

A class diagram with its relations

Quick start

  1. In the Explorer, right-click a folder and choose Scan Folder for C++ Classes.
  2. Enter the scan depth: -1 for the whole tree, 0 for the folder only, N for N levels of subfolders.
  3. Explore the diagram. Only inheritance is drawn at first: turn on the other relations in the side panel.

The command is also in the Command Palette: classScanner: Scan Folder for C++ Classes.

Headers in inc, sources in src? Scan either side: when the folder is inside a src (or source) folder and the same path exists under a sibling inc (or include) folder, or the other way round, both are scanned together. Scanning project/src/core also reads project/inc/core, so that classes find their methods.

What you get

A diagram that scales

Zoom out and each class becomes a colored tile in its namespace; zoom in and names appear, then every attribute and method. The whole diagram of a 1500-class project is scanned and laid out in about two seconds, and pans at close to 60 frames per second.

1500 classes grouped by namespace

Every relation, on demand

Seven kinds of relations, each with its own switch and its UML notation: inheritance, composition, aggregation, dependency, include, friend and nesting. Edges are thin, run horizontally and vertically, and leave each card from its own spot. Select a class to highlight its neighbors, or isolate its neighborhood to hide everything else.

Members, visibility and relations up close

Your code, read as it is

Classes, structs, unions, enums and templates, with their members, visibility, and static, virtual, const and pure virtual markers. Methods are marked with a diamond and attributes with a circle, colored by visibility: green for public, yellow for protected, red for private. Open a class in its header or in its source file from the selection bar, and Alt + click a member to jump to its declaration.

Layouts you can shape

Group classes by namespace, folder or file, switch to one global inheritance hierarchy, or let an organic layout pull related classes together. Related groups are placed side by side, and a collapsed group gives its room back. Drag cards where you want them: the arrangement is saved with your workspace, and every change can be undone.

Exports for people and for language models

Select classes and take them elsewhere:

  • PNG or SVG images of the view, the whole diagram or the selection.
  • A compact schema for an LLM, ready to paste into a prompt.
  • A .zip of their source files, headers and .cpp together.

The selection bar, light theme

Using the diagram

Action Effect
Mouse wheel Zoom around the cursor
Drag the background Pan
Click a card Select it and highlight its relations; a click never opens a file
Ctrl + click a card (Cmd on macOS) Add it to the selection, or remove it; Shift + click does the same
Ctrl + drag (Cmd on macOS) Select the cards in a rectangle; with Shift, add them to the selection
Drag a card or a group title Move it; dragging a selected card moves the whole selection
Alt + click a member line Open the member's declaration
Alt + click a card, elsewhere Open the class declaration
Double-click a card Cycle its display mode: auto, full, compact
Double-click a group title Collapse or expand the group
Right-click Display modes, isolate, open the header or the source file, go to the member under the pointer, exports, collapse the group
Ctrl + F Search a class, a method or an attribute
Ctrl + Z, Ctrl + Y Undo and redo moves, display modes, collapsed groups and layout changes
Escape Close the menu, clear the selection, then leave the isolation

The controls float above the diagram:

  • Top left: show or hide the side panel, search, undo and redo.
  • Top center: the layout, the grouping, Recompute layout, and the display mode of every card (auto follows the zoom, compact shows names only, full shows all members).
  • Top right: rescan and export.
  • Side panel: a switch per relation kind, what changes when zoomed out, the isolation depth, and filters by kind, namespace and folder.
  • Bottom: the status, the scan depth and the scan report on the left, zoom controls and the minimap on the right.
  • Selection bar: appears while classes are selected, with the actions that apply to them. For a single class it has one button per file, such as engine.h and engine.cpp: choose which one to open.

A file opens in the column on the right of the diagram, and only once: opening it again shows the editor it already has.

Two switches of the side panel, under Zoomed out, set what happens when you zoom out:

  • Simplify cards (on by default): cards show their name, then a plain tile. Turn it off to keep full cards at every zoom level.
  • Merge relations (off by default): every relation stays drawn. Turn it on to merge the relations between two groups into a single link when the view is far away.

Recompute layout lays the diagram out again. It reclaims the room left by cards made compact, and discards the manual moves of the current layout; like every change of the arrangement, it can be undone with Ctrl + Z. Checking or unchecking a kind under Show (classes, structs, unions, enums, templates, forward-declared only) does the same, so that hidden classes leave no hole; the namespace and folder filters hide cards without moving the others.

While a diagram is open, saving a C++ file of its folder (or of its paired folder) scans it again: the diagram follows your code, and keeps its arrangement. The depth of a folder is asked the first time only; click Depth in the status to change it.

Schema for an LLM

The LLM schema button of the selection bar copies a compact description of the selected classes to the clipboard: classes by namespace with their bases, members and file locations, then the relations that are turned on, with a legend.

Because the size of a prompt matters, the button first shows two options and an estimate of the size in tokens: which members to list (all, without the private ones, public only, or none) and whether to write the file locations.

namespace geo
  abstract class Shape  [include/geometry/shape.h:15]
    # origin: Point
    + virtual area() const: double = 0
  class Polygon : public geo::Shape  [include/geometry/shape.h:33]
    - vertices: std::vector<Point>

relations
  geo::Polygon *-- geo::Point [*]

Sources as a .zip

Export sources as .zip saves the files of the selected classes, keeping the folder tree or flat. For each class it takes the file that declares it, the files that define its methods, and the files with the same name in the folder that resembles its own the most: inc/core/engine.h brings src/core/engine.cpp with it, and include/myproject/engine.h brings src/engine.cpp.

Saved arrangement

Positions, pinned cards, collapsed groups, active relations, filters and the camera are saved in .classscanner/ at the root of the workspace. The file is plain JSON and can be committed to share an arrangement with your team.

Commands

Command Description
classScanner: Scan Folder for C++ Classes Scans a folder and opens its diagram
classScanner: Rescan Scans the folder of the active diagram again
classScanner: Change Scan Depth Asks for another depth and scans the active diagram again
classScanner: Export Diagram Exports images, the schema for an LLM, or the sources of the selection

Settings

Setting Default Purpose
classScanner.maxDepth -1 Depth suggested the first time a folder is scanned
classScanner.extensions [".cpp", ".hpp", ".h"] File extensions to analyze
classScanner.exclude build, out, node_modules, .git, third_party, external Glob patterns of files and folders to skip
classScanner.maxFileSizeKB 2048 Larger files are skipped and listed in the scan report
classScanner.ignoredMacros [] Macros removed before parsing, such as Q_OBJECT or DECLARE_DYNAMIC
classScanner.maxMembersInAutoMode 12 Member lines shown on a card that follows the zoom
classScanner.structuralRelations ["inherit", "compose"] Relations used to compute the layout
classScanner.rescanOnSave true Scan again when a C++ file of an open diagram is saved

Accuracy and limits

classScanner reads the code with tree-sitter, without compiling it. That is why it works on any project at once, and also why it cannot be as exact as a compiler:

  • Type names are resolved with the scope rules of C++, using namespace directives and typedef/using aliases, then by unique short name. Names that cannot be resolved are counted in the scan report, with the most frequent ones.
  • Export macros such as class MYLIB_API Widget are removed automatically. Other macros that confuse the parser, typically inside class bodies, can be listed in classScanner.ignoredMacros.
  • Every branch of #if blocks is read; a class declared in several branches is merged.
  • Free functions and typedefs are not shown as nodes.

The scan report, opened from the status at the bottom left, lists the files with syntax errors, the skipped files and the unresolved names.

Performance

Measured in VS Code 1.130.0 on a synthetic project of 1500 classes in 2000 files with about 24,000 relations, on a laptop with an integrated GPU:

Operation Measured
Scan 0.9 to 1.7 s
Layout 0.4 to 1.6 s, depending on the layout
Pan and zoom, every relation shown 57 to 60 frames per second
Turning a relation kind on or off under 40 ms

Requirements

VS Code 1.130.0 or later. No compiler or other tool is needed.

Feedback and source

  • Report a problem or suggest an improvement in the issue tracker.
  • Building the extension and running its tests: docs/DEVELOPMENT.md.
  • The specification: docs/SPEC.md.

License

BSD 3-Clause, see LICENSE.

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft