Closes #4497 adds favorited branches to the graph

Author: eamodio

CHANGELOG.md

@@ -6,6 +6,17 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
 
 ## [Unreleased]
 
+### Added
+
+- Adds expanded and improved branch favoriting ([#4497](https://github.com/gitkraken/vscode-gitlens/issues/4497))
+  - Adds a new "Favorited Branches" option to the branches visibility dropdown on the _Commit Graph_
+  - Adds _Add to Favorites_ or _Remove from Favorites_ context menu items to branches in the _Commit Graph_
+  - Adds _Add to Favorites_ or _Remove from Favorites_ context menu items to worktrees in the views
+
+### Changed
+
+- Changes branch favoriting to apply to both local and remote branch pairs ([#4497](https://github.com/gitkraken/vscode-gitlens/issues/4497))
+
 ## [17.3.1] - 2025-07-15
 
 ### Changed

docs/telemetry-events.md

@@ -1076,12 +1076,14 @@
 						"enum": [
 							"all",
 							"smart",
-							"current"
+							"current",
+							"favorited"
 						],
 						"enumDescriptions": [
 							"Shows all branches",
 							"Shows only relevant branches",
-							"Shows only the current branch"
+							"Shows only the current branch",
+							"Shows only favorited branches"
 						],
 						"default": "all",
 						"markdownDescription": "Specifies the visibility of branches on the _Commit Graph_",

package.json

@@ -107,7 +107,7 @@ export type DateSource = 'authored' | 'committed';
 export type DateStyle = 'absolute' | 'relative';
 export type FileAnnotationType = 'blame' | 'changes' | 'heatmap';
 export type GitCommandSorting = 'name' | 'usage';
-export type GraphBranchesVisibility = 'all' | 'smart' | 'current';
+export type GraphBranchesVisibility = 'all' | 'smart' | 'current' | 'favorited';
 export type GraphMultiSelectionMode = boolean | 'topological';
 export type GraphScrollMarkersAdditionalTypes =
 	| 'localBranches'

src/config.ts

@@ -193,3 +193,10 @@ export function isBranchStarred(container: Container, branchId: string): boolean
 	const starred = container.storage.getWorkspace('starred:branches');
 	return starred?.[branchId] === true;
 }
+
+export function getStarredBranchIds(container: Container): Set<string> {
+	const starred = container.storage.getWorkspace('starred:branches');
+	if (starred == null) return new Set();
+
+	return new Set(Object.keys(starred).filter(branchId => starred[branchId] === true));
+}

src/git/utils/-webview/branch.utils.ts

@@ -846,16 +846,28 @@ export class GlGraphHeader extends SignalWatcher(LitElement) {
 															Shows only relevant branches
 															<br />
 															<br />
-															<i>
-																Includes the current branch, its upstream, and its base
-																or target branch
-															</i>
+															<i
+																>Includes the current branch, its upstream, and its base
+																or target branch</i
+															>
 														</span>
 													</gl-tooltip>
 												`,
 												() => html` <code-icon icon="info" slot="suffix"></code-icon> `,
 											)}
 										</sl-option>
+										<sl-option value="favorited" ?disabled=${repo?.virtual}>
+											Favorited Branches
+											<gl-tooltip placement="right" slot="suffix">
+												<code-icon icon="info"></code-icon>
+												<span slot="content">
+													Shows only branches that have been starred as favorites
+													<br />
+													<br />
+													<i>Also includes the current branch</i>
+												</span>
+											</gl-tooltip>
+										</sl-option>
 										<sl-option value="current">Current Branch</sl-option>
 									</sl-select>
 								</gl-tooltip>