multi-workspace 3.2.1

Multi

multi

multi is a better way to work with VS Code/Cursor on multiple Git repos at once. It is an alternative to multi-root workspaces that offers more flexibility and control. With multi, you can gain control over how tasks, debug runnables, and various IDE and linter settings are combined from multiple project repos ("sub-repos") located within a root workspace folder.

Documentation

Features:

• Generates files in your root .vscode folder from sub-repo launch.json, tasks.json, and settings.json files.
• Generates CLAUDE.md files from Cursor rules.
• In monorepo mode, syncs sub-repo GitHub workflows into root .github/workflows.

Installation

Using pipx:

• Install pipx
• Run pipx install multi-workspace

Using uv

• Install uv
• Run uv tool install multi-workspace

Getting started

To get started, create a new workspace directory that will house all your related repos and run:

multi init

When prompted, paste in the URLs of all the repositories you want to have in your workspace. You can optionally specify descriptions of what they do, which will be used to create a new repo-directories.mdc Cursor/Claude rule.

For automation, create or edit multi.json directly and run multi sync.

It is recommended you also install the VS Code Extension that automatically keeps your project synced when edits are made to synced files. To manually sync, you can run multi sync.