Skip to content
| Marketplace
Sign in
Visual Studio Code>Extension Packs>CodebaseNotesNew to Visual Studio Code? Get it now.
CodebaseNotes

CodebaseNotes

Alex Tsirozidis

|
296 installs
| (3) | Free
Annotate your project's files & folders
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

CodebaseNotes

A VS Code extension that allows you to annotate your codebase's files AND folders directly on a project tree in the VS Code UI. Maintain clear documentation about the structure and purpose of the different parts of your codebase. Also serves as a great tool for onboarding or just personal learning. All notes are stored into a single json file that can be checked into a repo.

CodebaseNotes Demo

Features

Accessing CodebaseNotes

  • You can access CodebaseNotes by clicking on the "CodebaseNotes" icon in the Activity Bar.
  • Alternatively, use the keyboard shortcut:
    • Windows/Linux: Ctrl+Alt+C
    • macOS: Cmd+Option+C

Click on a file or folder and enter an annotation for it (it's autosaved)

Tutorial 1

You may put a number in front of your annotation to have it ordered by that in the Annotation List

Tutorial 2

If you right-click on a file, choose "Copy Relative Path" and paste that into an annotation, whenever this annotation is opened, it will also open the referenced file.

Tutorial 3

Your annotations are stored in a .codebasenotes-annotations.json file in your project's root directory. This file can be checked into a repo to share annotations with your team.

Tutorial 4

Requirements

  • Visual Studio Code version 1.74.0 or higher

License

This project is licensed under the MIT License. See the LICENSE file for details.

Support

If you encounter any problems or have any suggestions, please open an issue on our GitHub repository.


Happy coding with CodebaseNotes! 📝👨‍💻👩‍💻

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
© 2025 Microsoft