Visual Studio Code Extension

Keep every project one move away.

Project Manager helps you save favorites, auto-detect repositories, tag work by context, and move between local and remote codebases without losing track of what matters.

  • Save folders and workspaces as favorites
  • Auto-detect Git, Mercurial, SVN, and VS Code projects
  • Organize everything with tags, status bar actions, and a dedicated side bar
Project Manager side bar screenshot

What's new in 13.1

Modern project switching

Improved tags, improved auto-detection, and current-project highlighting keep the extension focused on daily navigation.

  • Profile support
  • Side Bar current-project highlight
  • Open VSX publishing
  • Getting Started walkthrough
  • Virtual Workspaces and Workspace Trust support

Features

Jump to the key capabilities.

Favorite projects

Save the work that matters and reopen it fast.

Project Manager starts with favorites. Save any folder or workspace as a named project, reopen it from the command palette, and keep your most important repos one action away.

Save Project

Turn the current folder or workspace into a favorite with a suggested name and a lightweight command-driven flow.

Open from anywhere

Use the project picker to reopen favorites in the current window or a new one, depending on how you want to switch context.

Save Project command screenshot

Automatic detection

Discover repositories without curating every entry by hand.

Project Manager can scan your configured base folders and surface Git, Mercurial, SVN, VS Code, or other folder-based projects automatically. You choose where it looks and how strict it should be.

Detection coverage

  • Auto-detect Git, Mercurial, SVN, and VS Code folders
  • Search configured base folders and glob patterns
  • Ignore folders like node_modules, out, or custom matches
  • Cache results between sessions for faster access

Detection controls

Limit recursion depth, skip nested projects, group detected results by type, and keep duplicate project names readable with parent folder hints.

{
  "projectManager.git.baseFolders": [
    "~/Sources",
    "d:\\MoreProjects\\code-*",
    "$home\\personal-coding"
  ],
  "projectManager.git.ignoredFolders": [
    "node_modules",
    "out",
    "typings",
    "test",
    "fork*"
  ],
  "projectManager.git.maxDepthRecursion": 4
}

Remote development ready

Work locally, remotely, or both without changing how you switch projects.

Local-first by default

  • Install locally and keep your normal machine workflow intact
  • Save Containers, SSH targets, WSL projects, and Codespaces as favorites
  • Open the right remote target automatically when selecting a saved project
  • Keep local and remote work visible in one familiar UI

Remote-first option

  • Run the extension on remote environments when most of your work lives there
  • Store favorites directly in the remote context instead of only locally
  • Use remote.extensionKind to force workspace-side execution
  • Keep remote detection and saved projects close to the machine that hosts them

Switching behavior

  • Show the current project in the status bar
  • Open projects in a new window when you need separation
  • Reuse empty windows when that better fits your flow
  • Keep current-project context visible while switching often

Portable configuration

  • Use custom locations for the projects file when sharing setups
  • Use home path shortcuts for portable configuration
  • Keep stable and insiders installations aligned if needed
  • Adapt the same project list model to local and remote environments

FAQ

Quick answers for common questions.

How does Project Manager discover projects?

It searches for subfolders that match the configured patterns for each kind of project. You can control how deep it searches and which folders should be ignored, keeping a clean and organized list of projects.

Can I keep local and remote projects together?

Yes! You can save any project as a favorite, regardless of its location, whether it's local or remote like WSL, Docker and even GitHub Codespaces.

Where are saved favorites stored?

Favorites are stored locally on your machine, ensuring quick access and synchronization across your projects. And you can customize the location in case you need to sync them with another device or service.

Can I assign a Profile to a project?

Yes! You can assign a Profile to a project, and the project will always use that Profile when opened.

Does it support symlinks in auto-detected projects?

Yes! You can use symlinks in any of the baseFolders settings, and all projects will be correctly recognized.

Does it work on VS Code forks like Cursor, Windsurf, and Antigravity?

Yes! It works on all VS Code forks, ensuring compatibility and seamless integration with your favorite tools.

I have a feature request, bug report, or suggestion.

If you have a feature request, bug report, or suggestion, please submit it through our GitHub Issues page. We appreciate your feedback!

I have a question that's not listed here.

If you have a question that's not covered in the FAQ, feel free to reach out through our support channels at GitHub Discussions. We're here to help!