Bookmark Flow is a Visual Studio Code extension for code bookmarks and workflow navigation. Organize related files, functions, and tasks into structured bookmark flows so you can jump between code locations, track progress, and keep context while coding.
Features
Flow-based code bookmarks: Group bookmarks into named flows to match features, tickets, or tasks.
Fast navigation: Jump to any bookmarked line from the explorer tree view.
Bookmark notes: Add descriptions to capture intent and context per bookmark.
Reorderable steps: Move bookmarks up or down to reflect your workflow sequence.
Editor highlights: See bookmarked lines with clear decorations while you code.
Inlay hints: Display inline hints for quick visual scanning of bookmarks.
Command palette support: Manage flows and bookmarks with dedicated commands.
Mermaid export: Export flows to Mermaid sequence diagrams or flowcharts.
Installation
Open the Extensions view in VS Code.
Search for "Bookmark Flow".
Click Install.
Usage
Creating a Flow
Click the + icon in the Flows view title to add a new flow.
Enter a name for the flow and press Enter.
Adding a Bookmark
Open a file and move the cursor to the line you want to bookmark.
Right-click in the editor and select Add Bookmark Here.
If you have multiple flows, you will be prompted to select a flow.
Navigating Bookmarks
Click on a bookmark in the Flows view to jump to the corresponding code.
Use the Next Bookmark and Previous Bookmark commands to navigate between bookmarks in the active flow.
Commands
Command
Description
bookmark-flow.addFlow
Add a new flow.
bookmark-flow.refresh
Refresh the flows view.
bookmark-flow.addBookmark
Add a bookmark to a flow.
bookmark-flow.deleteFlow
Delete a flow.
bookmark-flow.deleteBookmark
Delete a bookmark.
bookmark-flow.moveBookmarkUp
Move a bookmark up in the flow.
bookmark-flow.moveBookmarkDown
Move a bookmark down in the flow.
bookmark-flow.jumpToBookmark
Jump to the selected bookmark.
bookmark-flow.renameFlow
Rename a flow.
bookmark-flow.editNote
Edit the note of a bookmark.
bookmark-flow.nextBookmark
Jump to the next bookmark in the active flow.
bookmark-flow.prevBookmark
Jump to the previous bookmark in the active flow.
bookmark-flow.openAllBookmarks
Open all bookmarks in a flow.
bookmark-flow.exportMermaidSequence
Export a flow to a Mermaid sequence diagram.
bookmark-flow.exportMermaidFlow
Export a flow to a Mermaid flowchart.
Project Structure
docs/architecture.md - Architecture overview and data model.
docs/vsc-extension-quickstart.md - VS Code extension quickstart.
Open Source
LICENSE - MIT license.
CONTRIBUTING.md - How to contribute.
CODE_OF_CONDUCT.md - Community standards.
SECURITY.md - Vulnerability reporting.
SUPPORT.md - Support and contact.
Publishing (VS Code Marketplace)
Install vsce:
npm install -g @vscode/vsce
Package:
pnpm run compile
vsce package
Publish:
vsce publish
Contributing
If you have any suggestions or find any bugs, please create an issue on the GitHub repository.
