Surrounded by Slop

See the code you'll never read — automatic, navigable diagrams for your codebase, inside VS Code and Cursor. Built for the age of AI-generated code: when nobody read what was written, the map is how you stay oriented.

Everything runs locally. No code ever leaves your machine.

What you get

• Visualize File (⌘⇧V) — structure + call diagram of the current file. TypeScript/JavaScript with real type-checker resolution; Python via tree-sitter.
• Visualize Workspace — a module map of the whole repo, TS and Python on one canvas. Opens collapsed; click a module to expand its members. Huge or dense repos fold to a folder overview instead of a hairball.
• Visualize Function Flow — a control-flow chart of the function under your cursor: labeled true/false branches, loop back-edges, unreachable code dimmed and badged, and a per-variable read/write overlay.
• Navigate — click any box to jump to its source line; search, filter chips, isolate a node's neighborhood, hover for signatures.
• Export — draw.io, Mermaid, SVG, or raw JSON; what you export is exactly what you saw.

Quick start

1. Install, open any TypeScript or Python file.
2. ⌘⇧V (or right-click → Visualize File).
3. Click a box — you're at its declaration. That's the loop.

Settings live under Surrounded by Slop (slop.*): include/exclude globs, test-file handling, external modules, theme, layout direction.

Honest by design

Heuristic edges (e.g. Python calls) are drawn dimmed and marked low-confidence — the diagram never pretends to know more than the analyzer does. Guardrail messages tell you when something was skipped or folded, and the Output panel says why.

Docs, roadmap, contributing: github.com/georgyia/surrounded-by-slop