How to Open VS Code Projects in Separate Windows on Mac
Give each project a window without confusing editor tabs with projects.
How do I keep two projects in separate windows?
In VS Code, choose File → New Window, then File → Open Folder in that new window to open the other project. Keep the original project in its existing window. A second editor tab inside one window is a different thing.
Choose separate windows or a shared workspace.
A VS Code workspace contains one or more folders in a window. A multi-root workspace groups folders together; it is useful when you intentionally work across related repositories in one interface. Separate windows are useful when each project needs its own visible context. See the official workspace guide.
Neither choice duplicates the files. Opening the same folder again does not create an isolated copy or a new Git branch. If you need independent versions, set those up explicitly through your version-control workflow.
Make the project identity obvious.
- Open the first project and confirm the folder shown in Explorer.
- Create a new window and open the second project there.
- Check the folder, active file and source-control branch in each window.
- Keep terminal tasks with the project they belong to.
Before pasting a change, check the file path rather than relying only on a filename such as README or settings. Two projects can contain identically named files, and a familiar editor layout is not enough to distinguish them.
Already launching from Terminal?
If the code command is installed in your shell, code --new-window <folder> requests a new window for a folder. Replace the placeholder with your project path. VS Code documents this option and Mac command setup in its command-line guide. The menu route works without that setup.
Move between projects and their reference windows.
StillSwitch can present eligible VS Code windows as separate choices alongside browser or Terminal windows. It does not switch editor tabs, choose branches, move files or restart tasks. After selecting a project window, use VS Code’s own controls to reach the file or terminal you need.
This guide is about separating project contexts. The broader developer workflow covers moving between code and a browser, while Terminal windows and tabs explains shell-session choices.
Written by the maker of StillSwitch. Reviewed on . Controls can vary by app, keyboard layout and macOS version.
14 days free. No card. Apple Silicon and macOS 15 or later.