Skip to content
albertusdevPublic

About

Guided code review for humans and coding agents, in VS Code or your browser.

Topics

Resources

Contributing

Security policy

Stars

4 stars

Watchers

0 watching

Forks

Repository files navigation

vsdiff

Let your coding agent explain the change. Review it where the code lives.

vsdiff turns a Git diff into a guided review in VS Code or a local browser tab. Your agent writes the route: what changed, why it matters, and which lines need attention. You walk the stops, ask questions beside the code, and send your feedback back to the agent.

CI License: MIT

A guided review in vsdiff: follow the diff, leave an inline reply, pin the overview, and request changes

A 21-second walkthrough, from the review map to feedback for your agent.

Watch the full demo · Install · Try a review · How it works

A review you can follow

  • Start with the map. Chapters explain the change; stops link to real diff hunks. Uncovered files stay visible so the guide cannot hide the rest of the diff.
  • Keep room for code. Overview is a normal tab. Pin it beside the diff when you want both, or use Focus Review to hide the extra panels.
  • Ask at the right line. Reply under the agent's guide or add a line comment. Long explanations expand when you need them. Draft replies survive layout changes.
  • Give the agent something it can act on. Comments, replies, and your final decision are saved locally as structured data. The agent can wait for your review, read the feedback, fix the code, and reply in the same thread.

The diff, guide, and reviewer conversation in the same editor

vsdiff supplies the review interface and file format. It does not call a model, require an AI subscription, or send your code to a vsdiff service. Use any coding agent that can edit a JSON file and run a command.

Install

This early release is distributed as source and a VSIX. There is no Marketplace, OpenVSX, or npm installation yet.

You need Node.js 22 or later, pnpm 9.15.9,