Skip to content
| Marketplace
Sign in
Visual Studio Code>SCM Providers>Repo BoardNew to Visual Studio Code? Get it now.
Repo Board

Repo Board

Emanuele Bartolesi

|
1 install
| (0) | Free
| Sponsor
All your git repos on one board: auto-discovers every repo on disk, shows which ones are dirty, behind or ahead at a glance, and switches between them with Ctrl+Alt+P. Fetch or pull them all in one click.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

Repo Board logo

Repo Board

Every git repo on your machine, on one board in VS Code.
See which repos are dirty, behind or ahead at a glance. Jump into any of them with Ctrl+Alt+P.

Marketplace version Installs Rating MIT license

Install from the Marketplace  ·  Quick start  ·  Shortcuts  ·  Report an issue

Repo Board: search, filter by git state, switch between grid and list, light and dark themes

Why Repo Board

If you have more than a handful of repos, you know the routine. You cd around to remember which one has uncommitted work, forget to pull before starting, and scroll through File › Open Recent hoping the project is still there.

Repo Board replaces that with one screen:

  • It finds your repos for you. Point it at C:\code or ~/src once. Every repository underneath appears, and new clones show up by themselves.
  • It tells you where attention is needed. Uncommitted changes, commits to pull or push, merge conflicts, stashes and missing folders, for every repo, without opening any of them.
  • It gets you there fast. A fuzzy switcher from anywhere in VS Code, a keyboard-driven dashboard, and one click to open a repo, a terminal in it, or its page on GitHub, GitLab or Azure DevOps.
  • It keeps everything up to date in one go. Fetch all and Pull all run across every repo, four at a time, fast-forward only.

Features

The whole fleet at a glance

The strip at the top has one cell per repo, coloured by its git state. The chips under it filter the board to what matters right now: repos with changes, behind, ahead or unavailable. Sort by most changes and the repos that need you come first.

Repos with uncommitted changes, sorted by most changes

Colour Meaning
Yellow / tan Uncommitted changes (staged, modified or untracked)
Amber Behind its upstream: there is something to pull
Blue Ahead of its upstream: there is something to push
Red Merge conflicts
Green Clean and in sync
Hatched Folder deleted, or the drive or share is not connected

Colours come from your VS Code theme's own git decoration colours, so the board looks native in every theme.

Real git status on every tile

Each tile shows the branch, ahead/behind counts, how many files are staged, modified, untracked or conflicted, the stash count, the last commit and when it happened, a GitHub-style language bar, and the project's own logo if it has one. Fetch, pull and push buttons appear when there is something to do.

Most of this comes from a single git status --porcelain=v2 call per repo. A board of 80 repos refreshes in a few seconds and is shown instantly from cache while that happens.

Auto-discovery

Add one or more scan folders, and Repo Board walks them (three levels deep by default). It stops at each .git, never follows symlinks or junctions, and skips node_modules and friends. Repos you remove from the board stay removed, even if they are still on disk.

A switcher that knows your repos

Press Ctrl+Alt+P (Cmd+Alt+P on macOS) anywhere in VS Code. Type a few letters of a name, a path, a branch, a collection or a #tag. Pinned projects come first, then the ones you opened most recently. Each result has buttons to open it in a new window, open a terminal there, or pin it.

Search that understands developers

The dashboard search is fuzzy on names (chkweb finds checkout-web) and also matches paths, descriptions, branches, languages and collections. Start a word with # to filter by tag, and combine terms: #acme pay.

Search filtered to the #acme tag

Organise as much or as little as you like

Pin favourites to the top. Group repos into coloured collections. Add tags, an emoji or short icon, and a description. Sort by last opened, name, last commit or most changes, or pick My order and drag tiles and collections wherever you want them. Switch between the grid and a dense list.

Edit a project: name, description, icon, collection, colour and tags

List view in a light theme

Everything one right-click away

Open, open in a new window, open a terminal, open the remote in the browser, reveal in the file explorer, copy the path, fetch, pull, push, pin, edit or remove. The common ones have single-key shortcuts too.

Context menu on a repo tile

Everywhere in the editor

  • Sidebar tree with the same groups, inline branch and status, and rich tooltips.
  • Status bar item showing the current project and its change count. Click it to switch.
  • Last opened is tracked however you open a folder (Repo Board, File › Open, the recent list or the code CLI), so recent really means recent.
  • One list for every editor. VS Code, Insiders, Cursor, VSCodium and other VS Code-based editors on the same machine share the board, and open windows update each other live.

Quick start

  1. Install Repo Board from the Marketplace, or run:

    code --install-extension emanuelebartolesi.vscode-repoboard
    
  2. Click the Repo Board icon in the activity bar, or run Repo Board: Open Dashboard from the command palette.

  3. Choose Scan a folder for repos and pick the folder that holds your projects.

  4. From now on, press Ctrl+Alt+P to switch projects.

Want a single repo instead of a whole folder? Use Repo Board: Add Current Folder or Add Folder….

Keyboard shortcuts

Keyboard shortcuts dialog

Key Action
Ctrl+Alt+P Switch project, from anywhere in VS Code
/ Search the board
Arrow keys, Home, End Move between repos
Enter / Ctrl+Enter Open / open in the other window
T Open a terminal in the repo
B Open the remote in the browser
F / R Fetch / refresh status
P / E Pin / edit details
Del Remove from the board
Esc Clear the search
? Show all shortcuts

The switcher keybinding is repoBoard.switch, so you can rebind it in Keyboard Shortcuts.

Commands

Command What it does
Repo Board: Open Dashboard Opens the board in an editor tab
Repo Board: Switch Project… Opens the fuzzy project switcher
Repo Board: Add Current Folder Adds the open folder or .code-workspace
Repo Board: Add Folder… Adds one folder
Repo Board: Add Folder to Scan… Adds a scan folder and scans it
Repo Board: Scan Folders for Repos Re-scans all scan folders now
Repo Board: Refresh Status Re-reads git status, and fetches if fetchOnOpen is on
Repo Board: Fetch All Repos Fetches every repo that has an upstream
Repo Board: Pull All Repos That Are Behind Fast-forwards every repo that is behind
Repo Board: Pin / Unpin Current Project Toggles the pin on the open project
Repo Board: Remove Projects Whose Folder Is Gone Cleans up deleted folders; unplugged drives are kept
Repo Board: Forget Removed Repos Lets scans add repos you removed earlier
Repo Board: Open Data File Opens catalog.json for backup or hand editing

Settings

Setting Default Description
repoBoard.scanRoots [] Folders scanned for git repositories. ~ works. Kept per machine, never synced.
repoBoard.scanDepth 3 Folder levels searched below each scan folder (1–8)
repoBoard.autoScan true Re-scan when the dashboard opens, at most every 10 minutes
repoBoard.ignoreDirs node_modules, bin, obj, dist, … Folder names skipped by discovery and language detection
repoBoard.openInNewWindow false Open projects in a new window by default
repoBoard.showOnStartup false Open the dashboard in windows that start without a folder
repoBoard.defaultView grid grid or list
repoBoard.defaultSort recent manual, recent, name, commit or changes
repoBoard.fetchOnOpen true Background git fetch when the dashboard opens, so ahead/behind is real
repoBoard.cacheMinutes 5 How long git status is reused before it is read again
repoBoard.detectLanguages true Show the language bar
repoBoard.maxFilesScanned 10000 File cap per project for language detection
repoBoard.statusBar true Show the current project in the status bar

Privacy and safety

  • No telemetry, no account, no cloud. The only network traffic is git talking to your own remotes.
  • Background git never prompts. Status reads and background fetches disable terminal prompts, Git Credential Manager dialogs and askpass helpers. They never take the index lock, and run with repository hooks and core.fsmonitor turned off. Fetch, pull and push that you start yourself run like your own git, hooks included.
  • Pull never merges. Every pull is --ff-only. Bulk pull skips repos with conflicts. There is no "push all".
  • Credentials never leak into links. Remote URLs such as https://user:token@host/… are always stripped before they are shown or opened.
  • Your data is one readable file: %APPDATA%\repoboard\catalog.json on Windows, ~/Library/Application Support/repoboard on macOS, $XDG_CONFIG_HOME/repoboard (default ~/.config/repoboard) on Linux. Writes are atomic, and a damaged file is kept as a backup instead of being overwritten.

FAQ

Does it work with Cursor, VSCodium or Insiders? Yes. It runs in any editor that supports VS Code extensions, and every editor on the same machine shares one board.

Does it scan my whole disk? No. It only walks the scan folders you choose, to the depth you set, and stops at each repository it finds.

A repo shows "Git refuses this repo (dubious ownership)". What now? Git doesn't trust a folder owned by another user. Run the command shown on the tile (git config --global --add safe.directory <path>) and refresh.

Can I back up or move my board? Copy catalog.json (see Repo Board: Open Data File). It is plain JSON and safe to edit by hand.

Contributing

Bug reports, ideas and pull requests are welcome on GitHub.

git clone https://github.com/kasuken/vscode-repoboard.git
cd vscode-repoboard
npm install
npm run watch   # then press F5 to start an Extension Development Host
npm test        # unit tests

To work on the dashboard without starting VS Code, run node dev/serve.mjs and open http://localhost:5178/dev/harness.html. It accepts parameters such as ?theme=light, ?view=list, ?filter=changes and ?q=pay. dev/showcase.html wraps the same page in editor chrome; the screenshots in this README come from it.

Support

If Repo Board saves you time, leave a review on the Marketplace, star the repository, or sponsor the work. It really helps.

Inspired by Project Tiles by Dominik Mech. Released under the MIT license.

  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft