Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,14 @@ No changes yet.

---

## [1.2.1] - 2026-03-29

### Changed

- Updated macOS bookmark keyboard shortcuts in Git Worklists

---

## [1.2.0] - 2026-03-26

### Added
Expand Down
94 changes: 44 additions & 50 deletions docs/MANUAL.md
Original file line number Diff line number Diff line change
Expand Up @@ -288,104 +288,98 @@ Quick navigation across files using numbered bookmarks (1–9), similar to Intel

### Core Behavior

* Supports **9 bookmark slots (1–9)**
- Supports **9 bookmark slots (1–9)**

* Each slot holds **one location**
- Each slot holds **one location**

* A bookmark stores:
- A bookmark stores:
- file (repo-relative)
- line
- column

* file (repo-relative)
* line
* column
- Bookmarks are **persisted per repository**

* Bookmarks are **persisted per repository**

* Switching repository switches bookmark set automatically
- Switching repository switches bookmark set automatically

---

### Setting Bookmarks

You can set bookmarks in multiple ways:

* **Keyboard**

* `Ctrl + Shift + 1–9` or `Cmd + Shift + 1–9` -> Set bookmark
* **Editor right-click**
- **Keyboard**
- `Ctrl + Shift + 1–9` -> Set bookmark

* `GW: Set Bookmark…`
* `GW: Clear Bookmark…`
* `GW: Clear All Bookmark`
If a slot is already used:
- **Editor right-click**
- `GW: Set Bookmark…`
- `GW: Clear Bookmark…`
- `GW: Clear All Bookmark`
If a slot is already used:

* A confirmation dialog is shown
* You can **replace or cancel**
- A confirmation dialog is shown
- You can **replace or cancel**

---

### Jumping to Bookmarks

* `Ctrl + 1–9` or `Cmd + 1–9` -> Jump to bookmark
- `Ctrl + 1–9` -> Jump to bookmark

Behavior:

* Opens the file if not open
* Moves cursor to saved position
* Reveals location in editor
- Opens the file if not open
- Moves cursor to saved position
- Reveals location in editor

---

### Clearing Bookmarks

* Clear single bookmark:

* Command: `Clear Bookmark`
* Slot-specific commands available
- Clear single bookmark:
- Command: `Clear Bookmark`
- Slot-specific commands available

* Clear all bookmarks:

* View title action
* Context menu
* Confirmation required
- Clear all bookmarks:
- View title action
- Context menu
- Confirmation required

---

### Visual Indicators

* Bookmarks are shown in the **editor gutter**

* Each slot has its own icon (1–9)

* Decorations include:
- Bookmarks are shown in the **editor gutter**

* gutter icon
* subtle line highlight
- Each slot has its own icon (1–9)

* Decorations update automatically when:
- Decorations include:
- gutter icon
- subtle line highlight

* bookmark is set
* bookmark is cleared
* editor becomes visible
- Decorations update automatically when:
- bookmark is set
- bookmark is cleared
- editor becomes visible

---

### Behavior Notes

* Works on **any file inside the repository**
- Works on **any file inside the repository**
- not limited to changed files

* not limited to changed files
* Bookmarks outside repo are ignored
* Line numbers are safely clamped if file changes
* Decorations are editor-only (not shown in tree view)
- Bookmarks outside repo are ignored
- Line numbers are safely clamped if file changes
- Decorations are editor-only (not shown in tree view)

---

### Keybindings

Default:

* `Ctrl + Shift + 1–9` or `Cmd + Shift + 1–9` -> Set bookmark
* `Ctrl + 1–9` or `Ctrl + 1–9` -> Jump to bookmark
- `Ctrl + Shift + 1–9` -> Set bookmark
- `Ctrl + 1–9` -> Jump to bookmark

Users can override keybindings via VS Code settings.

Expand Down
36 changes: 18 additions & 18 deletions package.json
Original file line number Diff line number Diff line change
Expand Up @@ -510,109 +510,109 @@
{
"command": "gitWorklists.bookmark.set1",
"key": "ctrl+shift+1",
"mac": "cmd+shift+1",
"mac": "ctrl+shift+1",
"when": "editorTextFocus && !editorReadonly"
},
{
"command": "gitWorklists.bookmark.jump1",
"key": "ctrl+1",
"mac": "cmd+1",
"mac": "ctrl+1",
"when": "editorTextFocus"
},
{
"command": "gitWorklists.bookmark.set2",
"key": "ctrl+shift+2",
"mac": "cmd+shift+2",
"mac": "ctrl+shift+2",
"when": "editorTextFocus && !editorReadonly"
},
{
"command": "gitWorklists.bookmark.jump2",
"key": "ctrl+2",
"mac": "cmd+2",
"mac": "ctrl+2",
"when": "editorTextFocus"
},
{
"command": "gitWorklists.bookmark.set3",
"key": "ctrl+shift+3",
"mac": "cmd+shift+3",
"mac": "ctrl+shift+3",
"when": "editorTextFocus && !editorReadonly"
},
{
"command": "gitWorklists.bookmark.jump3",
"key": "ctrl+3",
"mac": "cmd+3",
"mac": "ctrl+3",
"when": "editorTextFocus"
},
{
"command": "gitWorklists.bookmark.set4",
"key": "ctrl+shift+4",
"mac": "cmd+shift+4",
"mac": "ctrl+shift+4",
"when": "editorTextFocus && !editorReadonly"
},
{
"command": "gitWorklists.bookmark.jump4",
"key": "ctrl+4",
"mac": "cmd+4",
"mac": "ctrl+4",
"when": "editorTextFocus"
},
{
"command": "gitWorklists.bookmark.set5",
"key": "ctrl+shift+5",
"mac": "cmd+shift+5",
"mac": "ctrl+shift+5",
"when": "editorTextFocus && !editorReadonly"
},
{
"command": "gitWorklists.bookmark.jump5",
"key": "ctrl+5",
"mac": "cmd+5",
"mac": "ctrl+5",
"when": "editorTextFocus"
},
{
"command": "gitWorklists.bookmark.set6",
"key": "ctrl+shift+6",
"mac": "cmd+shift+6",
"mac": "ctrl+shift+6",
"when": "editorTextFocus && !editorReadonly"
},
{
"command": "gitWorklists.bookmark.jump6",
"key": "ctrl+6",
"mac": "cmd+6",
"mac": "ctrl+6",
"when": "editorTextFocus"
},
{
"command": "gitWorklists.bookmark.set7",
"key": "ctrl+shift+7",
"mac": "cmd+shift+7",
"mac": "ctrl+shift+7",
"when": "editorTextFocus && !editorReadonly"
},
{
"command": "gitWorklists.bookmark.jump7",
"key": "ctrl+7",
"mac": "cmd+7",
"mac": "ctrl+7",
"when": "editorTextFocus"
},
{
"command": "gitWorklists.bookmark.set8",
"key": "ctrl+shift+8",
"mac": "cmd+shift+8",
"mac": "ctrl+shift+8",
"when": "editorTextFocus && !editorReadonly"
},
{
"command": "gitWorklists.bookmark.jump8",
"key": "ctrl+8",
"mac": "cmd+8",
"mac": "ctrl+8",
"when": "editorTextFocus"
},
{
"command": "gitWorklists.bookmark.set9",
"key": "ctrl+shift+9",
"mac": "cmd+shift+9",
"mac": "ctrl+shift+9",
"when": "editorTextFocus && !editorReadonly"
},
{
"command": "gitWorklists.bookmark.jump9",
"key": "ctrl+9",
"mac": "cmd+9",
"mac": "ctrl+9",
"when": "editorTextFocus"
}
]
Expand Down
Loading