OpenCode e LSP: o que o Language Server Protocol agrega ao agente?

Você abriu a documentação do OpenCode, viu a sigla LSP e pensou: que raio é isso e por que o agente precisa disso?

Calma que eu te conto

LSP é o Language Server Protocol, o mesmo protocolo que faz o seu editor sublinhar de vermelho o erro, mostrar o tipo quando você passa o mouse e pular direto pra definição de uma função

O OpenCode, que é o agente de IA de código open source da SST feito pro terminal, integra esses servidores LSP e usa a saída deles como feedback pro LLM na hora de editar arquivo

Se liga na ideia central: o LSP é a ponte entre a inteligência que o editor já tem e o modelo que está escrevendo o código pra você

O que o LSP entrega ao agente

Quando o OpenCode conecta num servidor LSP, ele ganha acesso ao mesmo tipo de inteligência de código que a sua IDE usa

Se você conhece o autocomplete e o "ir pra definição" do VS Code, é exatamente essa camada que entra em jogo aqui

As capacidades que o LSP entrega pro agente são:

• Diagnósticos (diagnostics): os erros e avisos que o language server encontra no arquivo, tipo variável não usada, tipo errado, import quebrado
• Hover / informação de tipos: o tipo de uma variável ou a assinatura de uma função, aquilo que apareceria ao passar o mouse
• Busca de símbolos (symbol lookups): localizar onde está definido um símbolo (função, classe, constante) no projeto
• Ir para definição (go-to-definition): saltar da chamada pro lugar exato onde a coisa foi declarada
• Encontrar referências (find references): todos os pontos que usam aquele símbolo
• Hierarquia de chamadas (call hierarchy): quem chama quem, o mapa de quem depende de quem

Cada uma dessas dá contexto real pro modelo

Em vez de o LLM adivinhar o tipo de um retorno ou onde uma função vive, ele consulta o language server e recebe a resposta certa

É a diferença entre editar às cegas e editar enxergando o código como o editor enxerga

Por que isso melhora a assistência do OpenCode

Aqui está o pulo do gato

O mecanismo é simples: ao editar um arquivo, o OpenCode consulta o servidor LSP, pega os diagnósticos e devolve isso pro LLM

Ou seja, o modelo escreve uma mudança, o language server analisa e diz "ó, aqui tem um erro de tipo", e essa informação volta pro modelo corrigir

O agente passa a corrigir com base em erro real apontado pelo language server, não só em suposição do que ele acha que deveria funcionar

E a comunicação por baixo? É via JSON-RPC sobre stdio (entrada/saída padrão)

"Que JSON-RPC?" É só o formato de mensagem que o cliente do OpenCode e o servidor LSP usam pra trocar figurinhas: um pergunta, o outro responde, tudo pela entrada e saída padrão do processo

Você não precisa mexer nisso, mas é bom saber que é esse trilho que carrega os diagnósticos de um lado pro outro

O resultado prático é um agente menos "vibe coder no chute" e mais colado na realidade do seu projeto

Como habilitar o LSP no OpenCode

A boa notícia é que dá pra ligar com pouca coisa

O LSP no OpenCode é controlado pela seção lsp do config, e o comportamento depende do que você coloca ali

1. Abra o config do OpenCode e adicione a seção lsp. Se você omitir essa configuração, o LSP fica desligado por padrão, então precisa declarar

2. Ligue todos os servidores built-in com lsp: true. Esse é o caminho mais direto pra deixar tudo habilitado de uma vez:

{
  "lsp": true
}

O erro comum aqui é esperar que o LSP já venha ligado de fábrica: se você não colocou a seção, ele estava desabilitado o tempo todo

3. Deixe os servidores subirem sozinhos. O OpenCode não sobe um servidor LSP até você acessar um arquivo que precise dele: a inicialização é lazy, disparada quando ele detecta a extensão suportada do arquivo aberto

4. Não se assuste com o download no primeiro uso. O OpenCode baixa e configura os servidores LSP automaticamente na primeira vez, então pode ter uma pausa inicial enquanto ele prepara a casa

5. Precisa desligar o download automático? Use a variável de ambiente. Dá pra desativar o download/configuração automática assim:

OPENCODE_DISABLE_LSP_DOWNLOAD=true

Útil em ambiente controlado onde você não quer que a ferramenta busque nada por conta própria

OpenCode na prática (vídeo)

Pra quem quer ver o agente rodando de verdade antes de mexer no config, deixo aqui um material do canal com o OpenCode em funcionamento no terminal

Conclusão

No fim das contas, o LSP é o que transforma o OpenCode num agente que enxerga o código como o seu editor enxerga

Diagnósticos, tipos, referências e definições deixam de ser palpite e viram informação vinda direto do language server, devolvida pro modelo na hora de editar

O próximo passo é curtíssimo: ligar lsp: true no config e abrir um arquivo do seu projeto pra ver o servidor subir sozinho

Aí é só deixar o agente corrigir com base no que o código realmente diz 😀