Skip to content

feat: add code environment support for Cascade - Windsurf's AI Agent #78

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: main
Choose a base branch
from

Conversation

Ishoshot
Copy link

@Ishoshot Ishoshot commented Aug 13, 2025

Add Windsurf IDE Support

Description

This PR adds support for Windsurf IDE to Laravel Boost, enabling Windsurf users to receive Laravel-specific AI guidelines through Cascade (Windsurf's AI assistant).

Motivation

Windsurf is a powerful AI-first IDE, and Laravel developers using Windsurf should have access to Laravel Boost's AI guidelines to improve their development experience. Currently, Windsurf users are excluded from the automated guideline installation process.

Implementation

Agent-Only Architecture

Windsurf is implemented as an Agent-only code environment:

  • Implements Agent interface - Provides AI guidelines
  • Does NOT implement McpClient interface - No automated MCP configuration

Technical Rationale

Unlike other supported IDEs (Cursor, PhpStorm, VSCode), Windsurf handles MCP server configuration differently:

IDE MCP Configuration Laravel Boost Approach
Cursor .cursor/mcp.json (per-project) ✅ Automated via McpClient
PhpStorm .junie/mcp/mcp.json (per-project) ✅ Automated via McpClient
VSCode .vscode/mcp.json (per-project) ✅ Automated via McpClient
Windsurf ~/.codeium/windsurf/mcp_config.json (global) ❌ Manual configuration only

Since Windsurf only supports global MCP configuration, Laravel Boost respects the principle of not modifying users' global settings automatically. However, users can manually configure the MCP server if desired.

Configuration Details

// Windsurf Configuration
Agent Name: "Cascade"
Guidelines Path: ".windsurf/rules/laravel-boost.md"
Project Detection: ".windsurf" directory
System Detection: Standard paths across macOS/Linux/Windows

## User Experience

### Automated Installation
When running `php artisan boost:install`, Windsurf users will now:

1. See Windsurf as an available option for AI guidelines
2. Receive Laravel-specific guidelines in `.windsurf/rules/laravel-boost.md`
3. Have Cascade automatically discover and apply these guidelines

Screenshots from my usage :)

Installation

Screenshot 2025-08-13 at 19 57 53

Boost's Discovery in Cascade

Screenshot 2025-08-13 at 19 56 56

Cascade In Action

Screenshot 2025-08-13 at 19 56 37

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants