Skip to content

Multi

Multi is the best 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.

Why Multi?

When working on projects that span multiple repositories, VS Code's multi-root workspaces can be limiting. Multi provides:

  • Unified branch management - Keep all your repos on the same branch with a single command
  • Configuration merging - Automatically combine .vscode settings, launch configurations, and tasks from all repos
  • AI assistant support - Generate CLAUDE.md files from Cursor rules for better AI context
  • Flexible structure - Sub-repos are simply cloned into your workspace directory, no submodules required
  • Workspace diagnostics - Detect common misconfigurations with multi doctor

Key Features

Branch Synchronization

Switch all repositories to the same branch simultaneously:

multi set-branch feature/my-feature

VS Code Configuration Merging

Merge launch.json, tasks.json, settings.json, and extensions.json from all sub-repos into your root .vscode folder:

multi sync vscode

Cursor Rules Sync

Generate repo descriptions from multi.json and convert Cursor rules to CLAUDE.md files:

multi sync rules

Monorepo GitHub Workflow Sync

In monoRepo mode, sync package workflows into root .github/workflows:

multi sync github

Workspace Diagnostics

Catch mode mismatches and setup issues early:

multi doctor

Cross-Repo Git Commands

Run git commands across all repositories:

multi git pull
multi git status

Quick Start

Get started in minutes:

  1. Install Multi: pipx install multi-workspace
  2. Create a workspace directory and run: multi init
  3. Add your repository URLs when prompted
  4. Install the VS Code Extension for automatic syncing

See the Getting Started guide for detailed instructions.