Branch Beacon
Branch Beacon icon
VS Code • Cursor

Make your current Git branch impossible to miss

Shows a big status bar badge and optionally recolors your title/status bar based on regex rules. Stay in the right branch—every time.

Works great in Cursor too. First match wins on regex color rules.

Features

Status bar branch badge

The current branch is prominently displayed in the status bar with custom colors.

Regex-driven color rules

Theme branches like main, hotfix\/.*, feature\/.*, release\/.* with background/foreground colors.

Optional UI recoloring

Updates workbench.colorCustomizations to recolor the title bar and status bar per rule.

Simple commands

Branch Beacon: Copy Current Branch and Branch Beacon: Refresh keep you fast and focused.

In action

Title bar and status bar recoloring screenshot
Status bar branch badge screenshot

First match wins: rules are evaluated top‑down for predictable theming.

Settings

"branchHighlighter.showStatusBar": true,
"branchHighlighter.updateTitleBarColors": true,
"branchHighlighter.rules": [
  { "pattern": "^(main|master|prod)$", "bg": "#1d9f61", "fg": "#ffffff" },
  { "pattern": "^stage|preprod|release(\\/.*)?$", "bg": "#ff9800", "fg": "#000000" },
  { "pattern": "^hotfix|bugfix(\\/.*)?$", "bg": "#e53935", "fg": "#ffffff" },
  { "pattern": "^feature(\\/.*)?$", "bg": "#3f51b5", "fg": "#ffffff" }
],
"branchHighlighter.defaultColors": { "bg": "#444444", "fg": "#ffffff" }

See repository README for all options and examples.