Code Notes is a VS Code extension that lets you take structured notes across your codebase and quickly jump between code and the notes that describe it.

It’s built for developers who:

• Leave TODOs but never find them again

• Keep random markdown files with scattered annotations

• Review large codebases and want organized context

• Work in teams and want traceable, navigable notes

• Code Notes gives you a dedicated sidebar to manage notes, reference exact files + lines, preview content, and jump back into the code instantly.

• Browse all notes

• Open, preview, and delete notes

• Refresh with one click

• Attach notes to specific files + line numbers

• Jump directly back to referenced code

• Works great for reviews, onboarding, debugging, refactoring

• Notes are stored as readable Markdown

• Easy to version, sync, and share

• You own your notes (no database, no vendor lock)

• Open notes from the tree view

• Open associated code reference in one click

Screenshots coming soon

• Activity Bar → Code Notes

• Sidebar tree listing all your notes

• Commands available in the view header & context menu

Install from VS Code Marketplace (coming soon) or

Clone the repo & run:

npm install
npm run watch

Then press F5 to launch the extension dev host.

You’ll find most actions in:

• Command Palette (Cmd/Ctrl + Shift + P)
• Code Notes sidebar
• Tree item right-click menus

Notes are stored locally in a Markdown directory (managed by the extension).

They’re human readable and version-control friendly.

Planned improvements include:

• Search & filtering

• Workspace-shared notes option

• Inline commenting UX

• Multiple notes per line

If you have ideas or feature requests, open an issue!

If this helps your workflow, consider sponsoring: 👉 https://github.com/sponsors/kyonru

MIT — feel free to hack, extend, and share.