CodeAtlas

CodeAtlas is a VS Code extension that builds a static relationship graph for TypeScript/JavaScript, Python, and Java workspaces.

Install and use

Package the extension with npm run package, then install the generated .vsix from VS Code's Extensions: Install from VSIX command. Open a folder workspace and run CodeAtlas: Scan Workspace. Scanning is explicit: activation never scans your files automatically. Open CodeAtlas: Open Graph to search symbols, filter node and relation types, expand a selected node, and navigate to source.

Use CodeAtlas: Export JSON or CodeAtlas: Export GraphML to select an export path inside the open workspace. The graph view's PNG action remains a Webview request and also asks VS Code where to save the file.

Release verification

The release acceptance suite verifies JavaScript/TypeScript, Python, and Java fixtures; a 1,000-file scan continues after an isolated file failure; and Webview graph responses are limited to 500 nodes. npm run package builds a VSIX containing the extension bundle and Webview assets without source maps, test fixtures, or development source directories.

Static-analysis limits

The graph is based on syntax-tree analysis, not runtime execution. Dynamic imports, reflection, generated code, framework conventions, indirect dispatch, and unresolved dependencies can be absent or represented with lower confidence. Treat it as a navigation and exploration aid, not proof of runtime behavior.