Bookmark files and folders inside your workspace, organize them into optional categories, and jump back to them quickly.
Features
- Add / remove via Explorer or editor-tab right-click, or
Bookmarks: Addfrom the command palette. - Dedicated Bookmarks activity-bar view; click an entry to open it, right-click for actions (rename alias, move to category, view details, remove).
- Optional flat categories. Empty categories persist; create them from the view title bar.
- Drag-and-drop reorder for both bookmarks and categories.
- Stale bookmarks (target deleted) are greyed out with a
(stale)label; clicking one warns and refreshes the view. - ★ badge on bookmarked files and folders in the Explorer (themed via
charts.blue). - Bookmarks follow VS Code-mediated renames and moves (Explorer rename, refactor) — exact-match and folder-prefix descendants both rewrite. Default-style aliases follow the new path; custom aliases stay.
Bookmarks: Go to…quick pick, searchable by alias, path, or category.
Usage
- Right-click a file or folder → Add Bookmark (or run
Bookmarks: Addfrom the command palette). - Open the Bookmarks view from the activity bar; click an entry to open it.
- Right-click an entry to rename its alias, move to category, view details, or remove.
Settings
| Setting | Default | What it does |
|---|---|---|
bookmark-manager.showBadge |
true |
Show a ★ badge on bookmarked files and folders in the Explorer. Turn off if the badge clashes with another decoration provider. |
bookmark-manager.autoRemoveStale |
false |
Automatically remove bookmarks whose target file or folder no longer exists. When off, stale bookmarks are kept and shown greyed out with a (stale) label. |
Storage
Per-workspace, in context.workspaceState. Not synced via Settings Sync, not visible from a different workspace.
Limitations
- Workspace-only — bookmarks must be inside
vscode.workspace.workspaceFolders. The workspace folder root itself can't be bookmarked. - Categories are flat (no nesting).
- Renames done outside VS Code (terminal,
git mv) aren't tracked; those bookmarks go stale.
Development
npm install
npm run watch # Extension Development Host
npm run lint # Linting
npm run format # Formatting
npm test # Tests
See CLAUDE.md for layout and conventions.