open-windsurf 0.1.1

Open multiple Windsurf (VS Code-based) instances for different directories/paths

Open Windsurf

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

Features • Installation • Usage • Examples • Options

✨ Features

🚀 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

📦 Installation

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

🚀 Usage

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 ...

📋 Examples

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

⚙️ Options

Option	Description
--wait	Wait for all Windsurf instances to close before exiting
--user-data-dir DIR	Specify a custom user data directory for all instances
--profile PROFILE	Use a specific profile for all instances
--new-window	Force opening in new windows

📋 Requirements

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

🛠️ 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 by Tom Dörr on March 5, 2025}