Branchmark

Create branch-specific bookmarks with notes in your code. Branchmark allows you to add bookmarks to specific lines in your code, attach notes to them, and easily navigate between them. Each branch gets its own .branch-bookmarks.yaml file, keeping your notes organized and separate across different branches.

Features

• 📌 Add bookmarks to specific lines in your code
• 📝 Add notes to your bookmarks
• 🔍 List and quickly navigate to your bookmarks
• 🗑️ Remove individual bookmarks or all at once
• 📊 View all bookmarks in a dedicated sidebar
• ↕️ Drag and drop to reorder bookmarks in the sidebar
• 🎯 Visual indicators in the editor gutter and overview ruler
• 🌿 Branch-specific bookmarks stored in .branch-bookmarks.yaml
• 🔄 Automatic bookmark file switching when changing branches

Usage

Adding Bookmarks

1. Place your cursor on the line you want to bookmark
2. Use the command palette (Cmd+Shift+P / Ctrl+Shift+P) and select "Add Branchmark"
3. Enter a note for your bookmark
4. The bookmark will appear in the sidebar and as a visual indicator in your code

Managing Bookmarks

• Click on a bookmark in the sidebar to jump to its location
• Hover over a bookmark in the sidebar to see the delete option
• Drag and drop bookmarks in the sidebar to reorder them
• Use the "Remove All Branchmarks" command to clear all bookmarks
• Bookmarks are automatically saved in .branch-bookmarks.yaml for the current branch

Bookmark File Structure

Each branch's bookmarks are stored in a .branch-bookmarks.yaml file with the following structure:

- note: "Your bookmark note"
  timestamp: "2024-03-20T12:00:00.000Z"
  lineNumber: 42
  filePath: "/path/to/your/file.ts"
  order: 0

The file is automatically created and managed by Branchmark, and you can:

• Commit it to version control to share bookmarks with your team
• Keep different bookmarks for different branches
• Manually edit the file if needed

Commands

• Branchmark: Add Branchmark - Add a bookmark at the current line
• Branchmark: List Branchmarks - Show a list of all bookmarks
• Branchmark: Remove Branchmark - Remove a specific bookmark
• Branchmark: Remove All Branchmarks - Remove all bookmarks

Installation

1. Open VS Code
2. Go to the Extensions view (Cmd+Shift+X / Ctrl+Shift+X)
3. Search for "Branchmark"
4. Click Install

License

This extension is licensed under the MIT License.