Project Manager Hub
Project Manager Hub is a git-aware project hub. Instead of a flat list of repository
names, it shows the state of every project at a glance - branch, ahead/behind,
working-tree changes and the last commit - ranks them by how recently and often
you actually use them, and groups them by folder, tag or remote.
Everything is local: no network, no tokens, read-only Git queries.
Screenshots
Coming soon.
Features
- Auto-discovery - scan folders or glob patterns for Git repositories and
.code-workspace files, ignore noisy folders, control the depth.
- Git status on every card - branch, detached HEAD, ahead/behind, staged /
modified / untracked / conflicted counts and the last commit.
- Frecency ranking - the projects you use most and most recently rise to the
top, with pinned projects always first.
- Sorting - Frecency, Needs attention, Name, Path or Recent.
- Grouping - by path segment below a base folder (default), by tag, by
remote organization, or none.
- Keyboard-first switching - a fuzzy QuickPick that opens with MRU order and
shows branch/status inline.
- Dashboard + tree - a rich webview dashboard and a native project tree.
- Project Manager import - bring your existing favorites across in one step.
- Settings Sync - your project list, tags and frecency travel between
machines automatically; no files to manage.
How it works
- Base folders and all preferences are regular VS Code settings, so they sync
through Settings Sync.
- Projects you save, their tags and pins, plus frecency data, live in VS Code
global state and are registered with
setKeysForSync, so they sync too.
- For each project the extension runs
git status --porcelain=v2 --branch,
git log -1 and reads remote.origin.url. It never writes to a repository,
never runs hooks, and inspects at most a bounded number of repositories in
parallel.
Requirements
- VS Code
1.85.0 or newer.
git available on PATH (optional; without it projects are still listed, just
without status).
Installation
Install Project Manager Hub from the Visual Studio Marketplace, or run
npm run vsix and install the generated .vsix.
Getting started
- Open the Project Manager Hub view in the Activity Bar.
- Add one or more folders to
projectDeck.baseFolders in settings.
- Open the Dashboard or the Projects tree and refresh.
- Pin, tag or open projects from the tree context menu.
Settings
| Setting |
Default |
Scope |
Description |
projectDeck.baseFolders |
[] |
window |
Folders or glob patterns to scan. |
projectDeck.ignoredFolders |
common build dirs |
window |
Folders skipped while scanning. |
projectDeck.maxDepthRecursion |
3 |
window |
Scan depth per base folder. |
projectDeck.groupBy |
path |
window |
path, tag, org or none. |
projectDeck.pathGroupDepth |
1 |
window |
Path segment used as the group name. |
projectDeck.multiTagGroups |
true |
window |
List a project in every tag group. |
projectDeck.sortList |
frecency |
window |
frecency, attention, name, path, recent. |
projectDeck.showGitStatus |
true |
window |
Show Git state on projects. |
projectDeck.collapseGroups |
false |
window |
Collapse groups by default. |
projectDeck.concurrency |
12 |
window |
Repositories inspected in parallel. |
projectDeck.openInNewWindow |
true |
window |
Open projects in a new window. |
projectDeck.statusBar |
true |
window |
Current project and branch in the status bar. |
Commands
| Command |
Description |
Project Manager Hub: Open Project |
Open a project in the current window. |
Project Manager Hub: Open Project in New Window |
Open a project in a new window. |
Project Manager Hub: Switch Project |
Fuzzy switch with status inline. |
Project Manager Hub: Save Current Project |
Save the current folder as a project. |
Project Manager Hub: Refresh Projects |
Re-scan and refresh Git status. |
Project Manager Hub: Import from Project Manager |
Import favorites from Project Manager. |
Project Manager Hub: Export Projects to JSON |
Export saved projects. |
Security
- Read-only: the extension never writes to your repositories and runs no hooks.
- No network access; only local
git queries and folder scanning.
- Only environment-independent project paths and metadata are stored.
Support the project
Project Manager Hub is free and open source. If it is useful to you:
- ⭐ Star the repository on GitHub — it helps other people find it.
- ☕ DonationAlerts — a one-time donation keeps the project alive.
License
MIT
| |
