Simple-Bookmark

Simple-Bookmark is a VS Code extension that keeps file and folder bookmarks in a dedicated Explorer tree. It is built for repeated workspace navigation, quick file operations, and low activation overhead.

Features

• Bookmark files and folders from Explorer or the Simple-Bookmark view.
• Open bookmarked files directly from the tree.
• Copy and paste bookmarked items into folders or back to matching original paths.
• Rename, create, remove, and bulk-remove bookmark entries.
• Expand or collapse bookmark folders from the view title and item context menus.
• Reflect missing or restored original files through bookmark sync status.
• Limit broad Explorer folder expansion to protect VS Code responsiveness.

Commands

Keybindings

Settings

Storage And Sync

Bookmark metadata is stored under the user home .bookmark directory, partitioned by workspace path. The extension migrates legacy workspace .bookmark metadata when needed.

File sync uses directory-level VS Code file watchers shared by bookmarks in the same folder. Watch events are filtered back to exact bookmarked paths, so the tree keeps the same visible behavior with fewer watcher objects. Save and file-system change events are debounced before metadata sync to reduce Extension Host work.

Build VSIX

bun run tools

Select tools --vsce in the tool menu. The build bundles src/extension.ts to out/extension.js, copies required runtime packages, and packages simple-bookmark-4.2.1.vsix with vsce package --no-dependencies.

Development Notes

• Edit TypeScript sources under src/; do not edit generated out/ files.
• Use bunx tsc --noEmit for type validation.
• Use bunx biome check <files> for focused lint and formatting diagnostics.
• Use the tools --vsce path for marketplace package validation.