Browse your code as a graph in VS Code.
See what a function calls. Attach docs that survive renames.
Python today · JavaScript/TypeScript, Rust and more on the way
Install · Quick start · Features · What's coming · How it is built · Contributing
Every time you open an unfamiliar function you rebuild the same map in your head: where it lives, what it calls, and what someone once wrote about it. V-NOC lets the computer keep that map. It reads your project, draws it as a tree and a canvas you can explore one level at a time, and keeps your notes attached to the code they describe, even after the code is renamed or moved.
| Folders, files, classes and functions in the side bar. Open any part of it as cards on a canvas. Focus on one node and both views show only it and what it holds. | Open a function to see what it calls, as cards joined by dashed lines. Explore a call to jump to where it lives, and climb from there. No wall of edges: you choose what to open. |
Attach Markdown to a function, class, file or folder. Rename it, move it, git mv its file: the doc is still there.
Docs are plain files in .vnoc/, so your team sees them when you commit.
|
V-NOC is a pre-release. In VS Code's Extensions view, search V-NOC and choose Install Pre-Release Version.
| Where | Get it |
|---|---|
| VS Code | Visual Studio Marketplace |
| Cursor, Windsurf, VSCodium | Open VSX |
| Offline / by hand | .vsix files on the releases page |
Languages: Python is the first. JavaScript/TypeScript, Rust and more are coming — see What's coming.
Platforms: macOS (Apple silicon and Intel), Linux x64 and Windows x64.
- Open a project in VS Code (Python, for now).
- Click the V-NOC icon in the Activity Bar.
- Click a function to see it, then Show Calls to see what it calls.
- Right-click anything and choose Add Doc… to write a note about it.
- Press
⊞in the view's title (or run V-NOC: Open Canvas) to see the code as a graph.
| Shortcut | Does |
|---|---|
Ctrl/Cmd+Alt+N |
V-NOC: Search… — find a node by name or path, from anywhere |
/ or Ctrl/Cmd+F |
Search inside the Structure view |
Ctrl/Cmd+Enter |
Focus the selected node |
Alt+← |
Go back one focus level |
V-NOC writes a short ID into the code and finds the code again by it, so a doc follows its code through renames and moves. In Python:
| Attached to | Where the ID goes |
|---|---|
| A function or class | One line in its docstring |
| A file | A comment at the top of the file |
| A folder | A hidden .vnoc-id file inside it |
A doc whose code is gone shows under Needs Attention, where you relink it or remove it.
V-NOC is early, and a lot more is on the way.
| Python is the first. JavaScript/TypeScript, Rust and more are next. Each language is one driver program, so adding one does not touch the rest of V-NOC. | Edit code and docs right on the canvas cards, without switching to an editor tab. |
| A CLI, an MCP server and skills so agents (Claude Code, Codex, opencode…) can read and write the docs of a node or function, read its code and follow its call tree. | An agent that walks you through a codebase on the canvas, opening functions and calls one step at a time as it explains them. |
| See what changed as functions, not lines: which were added, removed, updated or moved between two versions. | Who changed this function, when and how, through renames and moves. |
| Version | Theme | Status |
|---|---|---|
| 0.1 | The docs loop | ✅ Released |
| 0.2 | Calls | ✅ This release |
| 0.3 | Edit code and docs on the canvas | 🚧 Next |
| Later | More languages, coding agents (CLI · MCP · skills), walkthrough agent, changes as a graph, function history | 💭 Planned |
Have an idea or a language you want first? Say so on Discord or in an issue.
flowchart LR
ext["<b>VS Code extension</b><br/>TypeScript<br/>side bar + canvas (React webviews)"]
core["<b>core</b><br/>Rust<br/>the index, IDs, .vnoc/ files"]
drv["<b>language driver</b><br/>Rust · Python today<br/>outline, IDs to write, call trees"]
ext -- "JSON-RPC over stdio" --> core
core -- "JSON-RPC over stdio" --> drv
| Folder | What is in it |
|---|---|
crates/ |
The Rust workspace: the core, the domain types, the driver protocol |
drivers/python/ |
The Python language driver (its own Cargo workspace) |
extension/ |
The VS Code extension |
webview/ |
The side bar and canvas (React + Vite) |
shared/ |
TypeScript types and logic shared by the extension and the webview |
docs/ |
The design notes |
A new language is one driver program: see docs/06-drivers.md. Want to add one? That is a great place to start.
Contributions are welcome. To build from source:
pnpm install
cargo build
(cd drivers/python && cargo build)
pnpm -r buildThen press F5 in VS Code to run the extension. CONTRIBUTING.md has the toolchains, the tests and the conventions.
- 🐞 Bugs: run V-NOC: Report Issue… in VS Code (it fills in your versions), or open an issue.
- 💬 Questions and ideas: join the Discord.
- 🔒 Security: see SECURITY.md.
V-NOC is licensed under Apache-2.0. Third-party code in the binaries is listed in THIRD_PARTY_NOTICES.md. The pictures show httpx (BSD-3-Clause).
If V-NOC is useful to you, a ⭐ helps other people find it.

