Code Notes 📝
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.
✨ Features
🧭 Code References
Attach notes to specific files + line numbers
Jump directly back to referenced code
Works great for reviews, onboarding, debugging, refactoring
✍️ Simple Markdown Notes
Notes are stored as readable Markdown
Easy to version, sync, and share
You own your notes (no database, no vendor lock)
⚡ Fast Navigation
📸 UI Overview
Screenshots coming soon
Activity Bar → Code Notes
Sidebar tree listing all your notes
Commands available in the view header & context menu
🚀 Getting Started
Installation
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.
🎯 Core Commands
| Command |
Description |
Code Notes: Create Note |
Create a new note |
Code Notes: Select Note |
Switch the active note |
Code Notes: Add Reference |
Attach a code reference to a note |
Code Notes: Go to Reference |
Jump to referenced file + line |
Code Notes: View Note |
Open preview of current note |
Code Notes: Open Notes Directory |
Open storage folder for notes |
Code Notes: Delete Note |
Remove note |
Code Notes: Refresh Tree |
Reload notes list |
Code Notes: Open Note from Tree |
Open by clicking tree item |
Code Notes: View Note at |
View note related to current cursor (if exists) |
You’ll find most actions in:
- Command Palette (Cmd/Ctrl + Shift + P)
- Code Notes sidebar
- Tree item right-click menus
🗂️ Where are notes stored?
Notes are stored locally in a Markdown directory (managed by the extension).
They’re human readable and version-control friendly.
🔧 Roadmap
Planned improvements include:
If you have ideas or feature requests, open an issue!
If this helps your workflow, consider sponsoring:
👉 https://github.com/sponsors/kyonru
🏷️ License
MIT — feel free to hack, extend, and share.
