Focus Review Lens

Focus Review Lens helps reviewers focus on the meaningful edits in a file by dimming unchanged lines and showing hunk-level CodeLens summaries relative to a chosen git base ref.

Features

• Toggle focus mode for the active editor
• Diff against a configurable base ref
• Jump between changed hunks with keyboard shortcuts
• Copy a compact hunk summary to the clipboard

Installation

Install from the VS Code Marketplace or package the extension locally with:

npm install
npm run compile
npx @vscode/vsce package

Development

See CONTRIBUTING.md for local development and pull request guidance.

Build (requires Node.js + npm)

npm install
npm run compile

Press F5 in VS Code to launch the Extension Development Host, or npx vsce package to produce a .vsix.

Installing the .vsix manually (sharing with your team)

Once built, focus-review-lens-0.1.0.vsix is a single file — copy it anywhere (network share, Slack/Teams, email) and any teammate can install it without needing Node.js or building anything themselves.

Option A — VS Code UI:

1. Open the Extensions view (Ctrl+Shift+X).
2. Click the ... (More Actions) menu at the top of the panel.
3. Choose Install from VSIX...
4. Browse to the .vsix file and select it.
5. Reload VS Code if prompted.

Option B — command line:

code --install-extension focus-review-lens-0.1.0.vsix

(Run from any folder — the path to the .vsix can be relative or absolute.)

To update to a newer version later, just repeat either step with the new .vsix; VS Code replaces the previous install. To remove it, use the Extensions view's ... menu on the installed extension, or code --uninstall-extension local.focus-review-lens.

No git checkout, no MR, no build step is needed on the receiving machine — the .vsix already contains the compiled JavaScript.

Use

• Focus Review: Toggle for Active Editor — dim unchanged lines in the current file.
• Focus Review: Set Base Ref... — diff against a specific ref (default: the merge-base with the upstream tracking branch).
• Alt+Down / Alt+Up — jump to the next / previous changed hunk (while active).

Settings

• focusReviewLens.dimOpacity (default 0.35)
• focusReviewLens.defaultBaseRef (default: auto-resolve merge-base)
• focusReviewLens.recomputeDebounceMs (default 300)

Status

Built, unit-tested, packaged, and installed. npm install && npm run compile succeeded with zero TypeScript errors; node ./dist/test/runParserTests.js passes all 4 assertions against the plan's two-hunk fixture; npx @vscode/vsce package produced focus-review-lens-0.1.0.vsix (9.29 KB); installed into VS Code via code --install-extension focus-review-lens-0.1.0.vsix.

Not yet verified: the interactive commands (Toggle, Set Base Ref, hunk navigation) against a real git repo inside the VS Code UI — that needs a human driving the editor.