Problems I routinely ran into: - Adding TODO comments everywhere during reviews/debugging/etc and then forgetting where they are - Linking handwritten notes/logs to files - Jumping between multiple files during debugging and losing track of important spots - Context-switching costs when working on a feature and needing to shift to a critical bug in prod - Needing to quickly understand project scope and code created by a developer who left the team mid-project

Enter marker-groups.nvim: - TLDR; bookmarks, but with rich annotations, visual indicators, and smart organization.

Key Features: Smart markers – Single-line or multi-line with rich annotations Groups – Organize markers by feature, bug, review, etc. Visual indicators – See markers right in your code with virtual text Drawer viewer – Browse all markers with file context in a side panel Telescope integration – Fuzzy search through all your markers Persistent – Markers survive restarts and are saved automatically

Real-world usage examples:

Code Reviews: - Group all review comments together instead of scattering TODO comments throughout your code - Add contextual annotations like "CONCERN: This could cause memory leaks" - Quickly jump between review points without losing your place

Feature Development: - Create a group per feature branch to track implementation progress - Mark areas that need refactoring or optimization - Keep implementation notes organized and accessible

Debugging: - Group markers by investigation theme (e.g., "memory-leak-investigation") - Annotate suspicious code patterns with detailed context - Track reproduction steps and potential fixes

Difference from existing solutions:

I had a hard time finding a comparable plugin. https://github.com/winter-again/annotate.nvim was the closest I could find, but the repo has been archived for over a year. https://github.com/chentoast/marks.nvim is awesome at what it does, but it isn't focused on being a note-taking tool.

I hope you find this plugin a helpful addition to your existing workflow. Feel free to open issues and ask questions on Github or this post. Thanks for checking it out!