Windsurf

Qué es

Windsurf es el IDE AI-native flagship de Codeium — un fork de VS Code lanzado en 2024 que apostó fuerte por Cascade, un modo de coding autónomo que mira tu trabajo, corre comandos, edita a través de archivos y proactivamente sugiere próximos pasos. Donde Cursor se posicionó alrededor del composer Cmd-K y tab-completions, Windsurf fue más allá hacia territorio de "agente conduciendo el IDE por ti".

A mediados de 2025 OpenAI anunció su adquisición de Windsurf (junto con que el negocio core enterprise de Codeium se separaba aparte), así que la trayectoria futura está atada a la estrategia de producto de OpenAI. A mediados de 2026 Windsurf aún ships independientemente con pricing fuerte.

Es la herramienta a la que recurrir cuando:

• Quieres un IDE totalmente agent-driven en lugar de un panel de chat + completions.
• La capa gratuita importa (la cuota Cascade gratis de Windsurf es significativamente usable).
• Quieres IDE + agente autónomo en un binario, no VS Code + plugin.

Por qué destaca

Cómo instalar

# Descarga para macOS / Linux / Windows
# https://windsurf.com/download

# O vía Homebrew en macOS
brew install --cask windsurf

Tras instalar, inicia sesión con email o Google. La capa gratuita arranca al instante. Pro está cerca de $15/mes (sujeto a cambios post-OpenAI). Pon un .windsurfrules en la raíz del repo para dar a Cascade instrucciones project-specific.

Qué instalar dentro de Windsurf

Windsurf lee .windsurfrules (proyecto) y Memories (contexto persistente del workspace). Tres packs TokRepo para empezar:

• Plantillas .windsurfrules — reglas project tuneadas para el estilo de planning de Cascade
• Cascade Memories Pack — memorias bootstrap para convenciones de frameworks populares
• Stack de Servidores MCP — servers Postgres / GitHub / Filesystem compartidos con Claude Code

Lanza tokrepo install y tu .windsurfrules más Memories se encienden con la baseline que Codeium mostró en demos de lanzamiento.

Errores comunes

• Cascade saliéndose del script en tareas largas — sin restricciones de .windsurfrules, Cascade refactorea más de lo que pediste. Fija siempre el scope en las reglas.
• Rate limits de capa gratuita en loops de agente — generosa pero no infinita. Marca refactors largos para plan Pro o programa chunks.
• Memories acumulando ruido — las Memories crecen entre sesiones. Pódalas periódicamente vía el panel de Memories o Cascade empieza a referenciar contexto stale.
• Ubicación de config MCP server — Windsurf usa ~/.codeium/windsurf/mcp_config.json, no .claude/. No simlinkees; usa tokrepo migrate.
• Incertidumbre post-adquisición — pricing, capa gratuita y roadmap de features pueden moverse mientras OpenAI integra Windsurf con Codex CLI / ChatGPT. Evita construir workflows de equipo que asumen que las features actuales del tier Pro persistirán sin cambios.

Concepciones erróneas comunes

La gente a menudo confunde Windsurf con Cursor — ambos son forks de VS Code construidos alrededor de agentes AI — pero las filosofías de diseño difieren. Cursor se inclinó por invocación explícita (presionas Cmd-K, preguntas, aceptas). Windsurf se inclinó por autonomía (Cascade sigue pensando y proponiendo). Tras 2 años de competencia ambos han absorbido ideas del otro (Cursor añadió modo agente, Windsurf añadió composer explícito), así que el gap se cierra. El mayor diferenciador ahora es la adquisición OpenAI: post-adquisición Windsurf probablemente apretará su integración con modelos OpenAI y convenciones Codex CLI, mientras Cursor permanece independiente y multi-vendor.