Skip to content
yaredtsyPublic

About

No description, website, or topics provided.

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

 V-NOC

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

Marketplace Open VSX CI Licence: Apache-2.0 Discord

Install · Quick start · Features · What's coming · How it is built · Contributing

Open a function, see what it calls, follow a call to its own file

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.

Features

🌳 Structure, as a tree and a canvas

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.

🔗 Calls, one level at a time

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.

📝 Docs that stay with the code

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.

Install

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.

Quick start

  1. Open a project in VS Code (Python, for now).
  2. Click the V-NOC icon in the Activity Bar.
  3. Click a function to see it, then Show Calls to see what it calls.
  4. Right-click anything and choose Add Doc… to write a note about it.
  5. 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

Docs that survive refactors

Add a doc, rename the function: the doc stays

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.

What's coming

V-NOC is early, and a lot more is on the way.

🌐 More languages

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 on the canvas

Edit code and docs right on the canvas cards, without switching to an editor tab.

🤖 Coding agents

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.

🧭 Walkthrough agent

An agent that walks you through a codebase on the canvas, opening functions and calls one step at a time as it explains them.

🔀 Changes as a graph

See what changed as functions, not lines: which were added, removed, updated or moved between two versions.

🕓 Function history

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.

How it is built

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
Loading
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.

Contributing

Contributions are welcome. To build from source:

pnpm install
cargo build
(cd drivers/python && cargo build)
pnpm -r build

Then 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.

Licence

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.

About

No description, website, or topics provided.

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages