Git Root Status Bar
Shows the actual git repository root folder name (the folder that contains
.git, e.g. RepoA or RepoB) in the VS Code status bar — even when
the workspace you opened lives several folders deeper, like:
C:\Something\Repo\Something.code-workspace
This is handy if you keep multiple clones of the same repository checked out
side by side (e.g. for working on two branches at once): the branch name
alone doesn't tell them apart, but the repo root folder name does.
The folder name is read from VS Code's built-in Git extension — the same
source that already resolves your branch name — so it stays correct even
when the repo root isn't the same as your workspace folder.
Install
From the Marketplace: search for Git Root Status Bar in the Extensions
view, or install via the CLI:
code --install-extension profanterdev.git-root-status-bar
Build from source
Requires Node.js and npm.
npm install
npm run compile
npm run package
npm run package produces a .vsix file in this folder using @vscode/vsce
— no publisher account or marketplace registration needed to install it
locally or share it with someone else.
To install a locally built .vsix:
- VS Code UI: Extensions view →
... menu (top right) → "Install from
VSIX..." → select the file.
- CLI:
code --install-extension git-root-status-bar-<version>.vsix
Settings
| Setting |
Default |
Description |
gitRootStatusBar.alignment |
"left" |
Which status bar cluster to join. "left" puts it next to the built-in branch name. |
gitRootStatusBar.priority |
9999 |
Priority within its cluster. Higher = further left. VS Code's built-in branch/sync item sits at priority 10000, so 9999 places this item immediately after it. |
gitRootStatusBar.showIcon |
true |
Show a folder/repo icon before the name. |
If it doesn't show up
Make sure VS Code actually found the repository. If your workspace folder
is nested inside the repo, VS Code needs:
"git.openRepositoryInParentFolders": "always"
in your user settings.json. (You likely already have this working, since
your branch name is already showing correctly in the status bar — that
comes from the same detection.)
Open the Command Palette → "Developer: Toggle Developer Tools" → Console
tab, and check for errors mentioning git-root-status-bar.
Development
npm install
npm run watch # incremental compile, or press F5 in VS Code to launch an Extension Development Host
npm run typecheck
npm test
License
MIT
