XRS Code Notes

XRS Code Notes adds persistent, code-review-style comment threads to local files without modifying source code. Notes live in an indexed SQLite database in a user-selected folder and appear through VS Code's Comments UI.

Setup

When a project is opened for the first time, choose Select Folder and select where that project's notes should be stored. XRS Code Notes remembers the selection in VS Code's private workspace state, without writing an absolute path to the project's .vscode/settings.json. Returning to the same project reopens its database automatically; a different project has its own independently remembered location. Use XRS Code Notes: Select Storage Folder for This Project to change it later.

XRS Code Notes creates and manages xrs-code-notes.db in the selected folder. SQLite is embedded in VS Code; users do not install a database server or additional software. A folder or saved Workspace must be open so the project has a stable identity.

Usage

Select one or more lines (or place the cursor on a line), then run XRS Code Notes: Add Note from the Command Palette or editor context menu. Comment thread actions support replies, editing, deletion, navigation, and copying the note ID. Turning XRS Code Notes off removes its notes and commenting controls from code editors without deleting data.

Use the Add Reference Note link button while composing a comment, enter the target note ID, and choose the text displayed by the hyperlink. Available commands also include reload, show storage file, go to note, and toggle visibility.

Storage and performance

The database uses indexed notes and comments tables with transactional writes. Its schema version is stored in SQLite's user_version; users do not manage it. XRS Code Notes queries only open files and a prefetched window around visible lines, renders at most 500 threads per file, and incrementally updates changed threads. The database is not intended for manual editing.

Known limitation

Version 1 anchors notes by line numbers. Inserting or deleting lines above a note does not automatically move its saved range.