📋 Visão Geral

O Windsurf da Codeium (anteriormente chamado de Cascade) é um poderoso agente de IA integrado ao VS Code, projetado para desenvolvedores que precisam de assistência em tempo real para escrever, debugar e deployar código.

✓ Pontos Fortes

Deploy integrado com Netlify, controle completo de browser, sistema de memória persistente, suporte a múltiplas linguagens, e gerenciamento avançado de comandos de terminal.

⚠ Limitações

Foco principal em JavaScript/TypeScript e web apps, dependência de serviços externos para deploy, pode ser limitado para projetos não-web.

Características Principais

  • Deploy Automático: Deploy de apps web para Netlify com configuração automática
  • Browser Preview: Inicie previsões de browser para testar aplicações web
  • Memory System: Salve e recupere contexto importante com memória persistente
  • Command Management: Execute e monitore comandos assíncronos de terminal
  • Full Browser Control: Navegue, clique, preencha formulários e consulte console

📁 Operações de Arquivo

Ferramentas para leitura, escrita e manipulação de arquivos no sistema de arquivos local.

file_read
Lê conteúdo de arquivos locais com suporte a ranges de linha
file_write
Cria ou sobrescreve arquivos, com opção de append
file_str_replace
Substitui strings específicas em arquivos existentes
file_find_in_content
Busca por regex no conteúdo dos arquivos
file_find_by_name
Encontra arquivos por padrão de nome (glob)

Exemplo de Uso

file_read("config.json")

🔍 Codebase Search

Ferramentas poderosas para buscar e navegar pelo código do projeto.

codebase_search
Busca snippets de código mais relevantes por query semântica
view_code_item
Visualiza definições de classes, funções ou métodos específicos
find_by_name
Busca arquivos/diretórios usando fd com múltiplos filtros
grep_search
Busca exata por padrões usando ripgrep
💡 Dica

Use codebase_search para queries semânticas e grep_search para buscas exatas por padrões de texto.

🚀 Deploy & Exposição

Ferramentas completas para deploy e exposição de aplicações web.

deploy_web_app
Deploy apps JavaScript para Netlify automaticamente
read_deployment_config
Lê configuração de deploy antes de fazer deploy
check_deploy_status
Verifica status de deployment via windsurf_deployment_id
deploy_expose_port
Expõe port local para acesso público temporário
deploy_apply_deployment
Deploy estático ou Next.js para produção
browser_preview
Inicia preview de browser para servidor web local

Frameworks Suportados

Frameworks: eleventy, angular, astro, create-react-app, gatsby, gridsome, grunt, hexo, hugo, hydrogen, jekyll, middleman, mkdocs, nextjs, nuxtjs, remix, sveltekit, svelte
⚠ Importante

Sempre execute read_deployment_config antes de tentar deployment, e verifique o status após o deploy usando check_deploy_status.

🌐 Controle de Browser

Suite completa para automação e controle de browser - o Windsurf tem uma das APIs de browser mais completas disponíveis.

browser_view
Visualiza conteúdo da página atual
browser_navigate
Navega para URL específica
browser_restart
Reinicia browser e navega para nova URL
browser_click
Clica em elementos por índice ou coordenada
browser_input
Preenche campos de texto
browser_move_mouse
Move cursor para coordenada específica
browser_press_key
Simula pressionamento de teclas
browser_select_option
Seleciona opções em dropdown
browser_scroll_up
Rola página para cima
browser_scroll_down
Rola página para baixo
browser_console_exec
Executa JavaScript no console do browser
browser_console_view
Visualiza logs e erros do console

Workflow Típico de Teste

1. browser_navigate("http://localhost:3000") 2. browser_view() ← verifica estado da página 3. browser_input(index=0, text="Teste") ← preenche formulário 4. browser_click(index=1) ← clica no botão submit 5. browser_console_view() ← verifica logs/erros 6. repeat conforme necessário

💻 Shell & Commands

Gerenciamento avançado de comandos de terminal com suporte a processos assíncronos e monitoramento.

run_command
Propõe/comanda execução de comandos no shell
command_status
Verifica status de comandos em background
shell_exec
Executa comandos em shell específico
shell_view
Visualiza output de shell em execução
shell_wait
Aguarda processo em shell terminar
shell_write_to_process
Envia input para processos interativos
shell_kill_process
Termina processos em execução

Fluxo de Execução

run_command: propõe comando → usuário aprova ↓ Comando executado, retorna CommandId ↓ command_status: verifica progresso ↓ shell_view: visualiza output ↓ shell_wait/shell_kill: finaliza processo

💾 Memory System

Sistema persistente de memória para salvar e recuperar contexto importante do projeto e preferências do usuário.

create_memory
Cria, atualiza ou deleta memórias persistentes

Ações Suportadas

  • create: Cria nova memória com título, conteúdo, corpus e tags
  • update: Atualiza memória existente (fornecer Id)
  • delete: Remove memória (fornecer Id, deixar title/content vazios)

O que Salvar em Memória

  • Preferências do usuário
  • Solicitações explícitas para lembrar algo
  • Snippets de código importantes
  • Stack tecnológica
  • Estrutura do projeto
  • Decisões arquiteturais

🌍 Acesso Web

Ferramentas para busca e leitura de conteúdo da internet.

search_web
Busca documentos web relevantes por query
read_url_content
Lê conteúdo de URL HTTP/HTTPS específica
view_web_document_content_chunk
Lê chunks específicos de documentos web já baixados
info_search_web
Busca Search Engine com filtros de data
📚 Documentação

Use read_url_content para acessar documentação online diretamente dentro do agente.

🔧 Utilitários

view_file
Visualiza conteúdo de arquivos com ranges de linha
list_dir
Lista conteúdo de diretórios
make_manus_page
Cria página Manus a partir de arquivo MDX
suggested_responses
Sugere opções de resposta para perguntas ao usuário
message_notify_user
Envia mensagem sem exigir resposta
message_ask_user
Pergunta ao usuário e aguarda resposta
idle
Indica conclusão de tarefas (entra em idle)

📊 Métricas

Estatísticas de capabilities do agente Windsurf.

34
Total de Ferramentas
12
Ferramentas de Browser
7
Ferramentas Shell
5
Ferramentas Deploy
5
Ferramentas Codebase
4
Ferramentas Web
1
Memory System

⚠️ Considerações

Prós

  • Integração nativa com Netlify para deploy
  • Browser completo com console access
  • Sistema de memória persistente
  • Gerenciamento de processos assíncronos
  • Gratuito com bom limite de uso
  • Integração deep com VS Code

Contras

  • Foco em apps web JavaScript/TypeScript
  • Limitado para projetos Python/backend puro
  • Dependência de APIs externas para deploy
  • Curva de aprendizado das 34 ferramentas
⚠️ Segurança

O Windsurf executa comandos no terminal local e controla o browser. Use apenas com projetos de confiança e monitore as ações propostas pelo agente.