Stop Polluting Your Git History: Why Every Developer Needs a Contextual Code Scratchpad
Every developer knows the mental friction of managing fleeting thoughts while writing code. You are deep in a complex component refactor, and suddenly you spot an unhandled edge case, an optimization idea, or a high-level architectural thought.
What are your options today?
- Leave a `// TODO` comment: It litters the source code, risks leaking internal notes into pull requests, and pollutes your git history.
- Open an external note-taking app: Switching windows breaks your flow state, and within an hour, you forget which exact file or line the note was referencing.
To eliminate this friction, we built Drafts Lab Notes—a lightweight, private developer scratchpad designed to keep your thinking in sync with your editor.
Why Traditional Notes Fall Short (The Git & Context Problem)
When looking for ways to capture code-adjacent thoughts, developers usually run into two extremes:
- In-Code Comments (`// TODO`): While contextual, they are public. They show up in
git diff, risk getting merged into production by mistake, and clutter clean codebases. - External Scratchpads (Notion, Apple Notes, etc.): Completely private, but completely disconnected from your workspace. They lack context and git awareness.
This is where the contrast matters. Drafts Lab Notes bridges the gap by being truly git-ignored and contextual. It anchors your notes to specific lines of code without writing a single artifact to your repository, giving you the privacy of an external scratchpad with the precision of an inline editor comment.
┌─────────────────────────────────────────────────────────┐ │ DRAFTS LAB NOTES │ ├──────────────────────────┬──────────────────────────────┤ │ 📍 Code-Anchored Notes │ 🔒 100% Private & Git-Clean │ │ 📝 General Scratchpad │ 🌿 Git-Branch Aware │ │ ✅ Task Status Lifecycle │ 🤖 AI & MCP Server Ready │ └──────────────────────────┴──────────────────────────────┘
1. Smart Contextual Code Anchoring
Attach notes directly to a specific code snippet or line. With built-in line-drift tracking, your notes stay aligned with the target logic even as surrounding code evolves during edits.
2. Zero Repo Pollution (100% Local Storage)
Unlike extensions that create .vscode/ configuration files or force you to manage .gitignore tweaks, Drafts Lab Notes saves everything in isolated local machine application storage. Write candid thoughts and debugging notes with zero fear of accidental commits.
3. General Project Scratchpad
Need to write down meeting action items, high-level architecture decisions, or quick text snippets? Use the general Notes mode to keep an unanchored workspace scratchpad side-by-side with your code.
4. Git-Branch Awareness
Switching branches can often orphan files or break note references. Drafts Lab Notes tracks branch context so your notes gracefully handle branch switches without data loss.
5. AI-Ready with Model Context Protocol (MCP)
The extension includes an opt-in local MCP (Model Context Protocol) server. This allows AI coding assistants (like Claude, Cursor, and custom agent workflows) to read and manage your contextual notes seamlessly alongside you.
How to Get Started
Installation: Search for Drafts Lab Notes in the VS Code Marketplace or the Open VSX Registry (for users of Antigravity, Cursor, VSCodium, and other open-source editors), or install it directly using the command ID:
@id:arifur561.drafts-lab-notes
Quick Usage:
- Add a Code Note: Highlight a line, open the Command Palette (
Ctrl+Shift+P/Cmd+Shift+P), and run Drafts Lab Notes: Add Note to Current File. - Add a General Note: Click the
+icon in the sidebar or run Drafts Lab Notes: Add Note. - Filter & Navigate: Filter notes by Current File, Current Directory, Notes, or All, and jump straight to the source with a single click.
Conclusion
Your editor should support your thinking process without cluttering your codebase. Try Drafts Lab Notes today and keep your workspace clean, organized, and focused.
- Explore more developer tools at DraftsLab.
- Download on the Visual Studio Marketplace.
- Available on Open VSX for alternative IDEs.