NotesGutter – Clean Code Notes with Markdown and Drawings

Name: NotesGutter – Clean Code Notes with Markdown and Drawings
Availability: InStock
Author: alohaTool

by alohaTool·Feb 20, 2026·1 point·0 comments

Visit Project View on HN

AI Analysis

●●SolidSolve My ProblemNiche Gem

Out-of-band code annotations with Excalidraw, but comment management is still crowded.

Strengths

•Addresses genuine pain: comment rot in complex code is real, this isolates docs cleanly
•Excalidraw integration for inline diagrams is a thoughtful UX—better than ASCII boxes
•Git-native storage means notes version with code, no external state

Weaknesses

•Adoption depends on team buy-in; solo tool doesn't prevent new developers from inlining comments anyway
•Early stage (3 installs)—proof of concept more than established solution

Post Description

I built NotesGutter for VS Code, Cursor etc to stop "comment rot." Instead of 20-line comments cluttering your source, you attach rich Markdown notes and Excalidraw diagrams to specific lines via small anchors.

The Workflow:

Markdown Side-Peek: High-fidelity documentation for complex logic. Infinite Canvas: Draw architecture diagrams directly linked to functions. Git-Native: Notes are stored in a .notesgutter folder. They version with your code and work 100% offline. Privacy: No cloud. No tracking. Your data stays in your repo.

Preview: https://github.com/ParasKoundal/NotesGutter/raw/main/Preview...

Install: Search "NotesGutter" in the VS Code/Cursor/Antigravity Marketplace or find it here: https://marketplace.visualstudio.com/items?itemName=ParasKou... https://open-vsx.org/extension/ParasKoundal/notesgutter

I'd love to hear what you think about it : https://github.com/parasKoundal/NotesGutter.