Bookmark Flow is a Visual Studio Code extension that lets you bookmark code in organized "flows". A flow represents a task, feature, or context so you can navigate your work with clarity.
Features
Flows: Create, rename, and delete flows to organize your bookmarks.
Bookmarks: Add bookmarks to your flows from the editor.
Navigation: Jump to any bookmark from the flow view.
Reordering: Reorder bookmarks within a flow to match your workflow.
Notes: Add descriptions or notes to your bookmarks.
Decorations: Bookmarked lines are highlighted in the editor.
Inlay Hints: Display inlay hints for bookmarks.
Tree View: View all your flows and bookmarks in a dedicated tree view in the explorer.
Commands: A rich set of commands for managing flows and bookmarks.
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.
