A simple utility to open multiple Windsurf (VS Code-based) instances for different directories/paths.

Features • Installation • Usage • Examples • Options

🚀 Multiple Instances - Open different projects in separate Windsurf windows
🔍 Path Validation - Automatically checks if paths exist
⚙️ Flexible Options - Supports profiles, custom data directories, and more
💻 Simple Interface - Easy to use command-line tool
📦 Poetry Package - Easy installation and dependency management

From Source

# Clone the repository
git clone https://github.com/yourusername/open-windsurf.git
cd open-windsurf

# Install with Poetry
poetry install

# Activate the virtual environment
poetry shell

Using pip (once published)

pip install open-windsurf

When installed with Poetry

# Within Poetry shell
open-windsurf PATH1 PATH2 PATH3 ...

# Or using Poetry run
poetry run open-windsurf PATH1 PATH2 PATH3 ...

When installed with pip

open-windsurf PATH1 PATH2 PATH3 ...

Open two separate Windsurf instances for different projects:

open-windsurf ~/projects/project1 ~/projects/project2

Open multiple projects with a specific profile:

open-windsurf --profile coding ~/projects/project1 ~/projects/project2

Open multiple projects and wait for all instances to close:

open-windsurf --wait ~/projects/project1 ~/projects/project2

• Python 3.8+
• Windsurf installed and available in your PATH
• Poetry (for development)

# Clone the repository
git clone https://github.com/yourusername/open-windsurf.git
cd open-windsurf

# Install development dependencies
poetry install

# Run tests
poetry run pytest

# Format code
poetry run black open_windsurf
poetry run isort open_windsurf

Generated with ❤️ by Windsurf and Sonnet 3.7

_{Created on March 5, 2025}