omnyx-windsurf 0.1.0

Omnyx personality adaptation for Windsurf IDE via MCP

Omnyx Windsurf Plugin

Personality-driven adaptation for Windsurf IDE via MCP (Model Context Protocol) and settings injection.

Installation

cd omnyx-windsurf
pip install -e .

How It Works

Windsurf supports MCP (Model Context Protocol) — an open standard for extending AI capabilities. This plugin provides:

1. MCP Server — Windsurf connects to omnyx-windsurf as an MCP tool
2. Settings Injection — Modifies .windsurfrc with personality-driven configurations
3. Cascade Context — Injects personality context into every AI interaction

Architecture

┌──────────────┐     ┌──────────────┐     ┌─────────────────┐
│   Windsurf   │◄───►│ omnyx-windsurf│◄───►│  Omnyx Backend  │
│    IDE       │ MCP │   MCP Server  │     │  (/api/agentic) │
│              │     │               │     │                 │
│ • Cascade    │     │ • Personality │     │                 │
│ • Settings   │     │   analysis    │     │                 │
│ • Config     │     │ • Autonomy    │     │                 │
│   files      │     │   mapping     │     │                 │
└──────────────┘     └──────────────┘     └─────────────────┘

Setup

Step 1: Configure MCP in Windsurf

Add to your Windsurf MCP config:

macOS: ~/Library/Application Support/Windsurf/mcp_config.json Linux: ~/.config/Windsurf/mcp_config.json Windows: %APPDATA%\Windsurf\mcp_config.json

{
  "mcpServers": {
    "omnyx": {
      "command": "omnyx-windsurf",
      "args": ["mcp"],
      "env": {
        "OMNYX_API_KEY": "omx_your_key_here"
      }
    }
  }
}

Or use the setup helper:

omnyx-windsurf setup --api-key omx_... --install-mcp

Step 2: Configure Windsurf Settings

The plugin can auto-configure .windsurfrc:

omnyx-windsurf configure-windsurf

This creates/modifies:

// .windsurfrc
{
  "omnyx.enabled": true,
  "omnyx.autonomy_level": "adaptive",
  "omnyx.planning_mode": "detailed",
  "omnyx.verbosity": "profile_based",
  "omnyx.test_generation": "comprehensive",
  "omnyx.cascade.context_injection": true
}

Usage

Automatic (Recommended)

Once configured, Windsurf automatically:

1. Sends task context to Omnyx via MCP
2. Receives personality profile and adaptation settings
3. Adjusts Cascade behavior in real-time

Manual Context

Users can also invoke Omnyx explicitly in Cascade:

@omnyx check my personality profile
@omnyx adapt this task for my style

MCP Tools Provided

The plugin exposes these MCP tools to Windsurf:

omnyx_get_profile

Get current personality profile and confidence score.

Returns:

{
  "confidence": 0.82,
  "autonomy_level": "checkpointed",
  "planning_style": "detailed",
  "communication_style": "thorough",
  "last_updated": "2024-01-15T10:30:00Z"
}

omnyx_adapt_task

Get autonomy configuration for a specific task.

Input:

{
  "task_description": "Build user authentication",
  "estimated_scope": "medium",
  "file_context": ["src/auth.py", "src/models.py"]
}

Returns:

{
  "autonomy": "checkpointed",
  "planning_depth": "detailed",
  "test_coverage": "comprehensive",
  "cascade_instructions": "[Context: User prefers comprehensive solutions]"
}

omnyx_get_suggestions

Retrieve pending personalization suggestions.

omnyx_accept_suggestion / omnyx_dismiss_suggestion

Manage suggestion workflow.

Privacy Modes

Configure via .windsurfrc or CLI:

# Mode 1: Full context (default)
omnyx-windsurf config --privacy-mode raw_prompts

# Mode 2: Task only (no file contents)
omnyx-windsurf config --privacy-mode task_only

# Mode 3: Paused
omnyx-windsurf config --privacy-mode paused

Commands

omnyx-windsurf setup --api-key omx_...     # Initial configuration
omnyx-windsurf configure-windsurf          # Install MCP config
omnyx-windsurf status                      # Show profile and connection
omnyx-windsurf mcp                         # Start MCP server (for Windsurf)
omnyx-windsurf config                      # View/change settings
omnyx-windsurf check "task description"    # Test adaptation
omnyx-windsurf forget                      # Clear all data

Integration with .windsurfrc

The plugin modifies .windsurfrc to inject context:

{
  "cascade.system_prompt": "[Omnyx: User prefers detailed explanations with trade-off analysis. Confidence: 82%]",
  
  "omnyx.autonomy": {
    "level": "checkpointed",
    "checkpoint_frequency": "major_decisions"
  },
  
  "omnyx.style": {
    "verbosity": "high",
    "warmth": "medium",
    "structure": "detailed"
  },
  
  "omnyx.testing": {
    "coverage": "comprehensive",
    "include_edge_cases": true
  }
}

Development

# Run MCP server directly for testing
omnyx-windsurf mcp --debug

# Test task adaptation
omnyx-windsurf check "Refactor authentication module"

Differences from omnyx-devin

Aspect	omnyx-devin (Cognition)	omnyx-windsurf
Integration	Requires vendor support	✅ MCP protocol (works now)
Config method	API calls	.windsurfrc settings
Context	Task descriptions	Files + workspace context
Real-time	Batch	✅ Live via MCP
UI injection	None	✅ Cascade system prompt