O que é Serena?
O Serena, da Oraios AI, é um servidor MCP que dá a um agente de programação as ferramentas de navegação e edição de código que uma IDE tem. Em vez de ler arquivos inteiros e editar por número de linha, o agente pode encontrar um símbolo, listar quem o referencia, substituir o corpo de uma função ou renomear um símbolo em todo o projeto. A versão 2.0.0 (13 de outubro de 2026) acrescentou uma interface baseada em REPL, na qual o agente envia código em vez de chamadas de ferramenta isoladas, e a 2.1.0 veio em 19 de outubro; o repositório tem cerca de 30.600 estrelas no GitHub.
Por padrão, ele roda sobre language servers (os motores que os editores usam para ir à definição), que, segundo o README, cobrem mais de 40 linguagens. Um plugin pago do Serena para IDEs JetBrains é o segundo backend e acrescenta mover, inline, hierarquia de tipos e um depurador interativo. Ele também tem um sistema simples de memória e ferramentas opcionais de arquivos, busca e shell, que vêm desativadas dentro de ambientes como o Claude Code, que já as têm.
Você o instala com uv (uv tool install -p 3.13 serena-agent), roda serena init e depois aponta o cliente para ele via stdio ou HTTP. Um painel web inicia com cada sessão em localhost:24282.
Como instalar Serena
uv tool install -p 3.13 serena-agentSerena vale a pena?
A maioria dos agentes de programação ainda explora um projeto com grep e leitura de arquivos inteiros, e edita casando texto. O Serena troca isso por operações que entendem símbolos: encontrar uma função, ver todos os chamadores, trocar seu corpo, renomeá-la em todo lugar. Em uma base de código grande, isso significa menos tokens gastos lendo e menos edições quebradas, que é toda a proposta, embora a economia seja afirmada pelos mantenedores, e não medida de forma independente.
O backend gratuito de language servers cobre o essencial: encontrar símbolo, referências, estrutura de arquivos, diagnósticos, renomeação de símbolos e edição por símbolo. As refatorações maiores (mover, inline, remover código não usado) e a depuração exigem o plugin pago para JetBrains, então o plano gratuito é mais limitado do que a tabela de recursos sugere à primeira vista, e algumas linguagens exigem instalar language servers adicionais.
A segurança é o motivo de uma nota menor. A própria página de segurança do Serena diz que ele parte do princípio de que o repositório em que trabalha é confiável, e 2026 mostrou o que isso significa: três avisos publicados, cada um terminando em execução de código. Uma falha crítica de injeção de template (corrigida na 1.7.0) e um cache de símbolos serializado com pickle (corrigido na 2.0.0) permitiam que um repositório malicioso executasse código só por ser ativado, e um bug anterior permitia que qualquer página web alcançasse o painel sem autenticação por DNS rebinding (corrigido na 1.5.2). Todas estão corrigidas, mas quem aponta um agente para código não confiável deve rodar o Serena em um contêiner, como os próprios mantenedores recomendam.
Dois padrões merecem atenção: o painel inicia com cada sessão, e o Serena envia dados anônimos de uso na inicialização, a menos que SERENA_USAGE_REPORTING seja definido como false. A "avaliação" do README cita agentes de IA elogiando a ferramenta, o que é marketing, não evidência, e ele desaconselha instalar por marketplaces de MCP ou de plugins, porque os comandos deles estão desatualizados.
A licença importa para algumas equipes: o aplicativo é GPL-3.0-or-later e contribuições exigem um CLA. Rodá-lo como ferramenta local não tem problema; embuti-lo em um produto fechado, sim. Em scripts pequenos, a configuração e as descrições extras de ferramentas custam mais do que economizam, e o grep e a edição embutidos do agente dão conta do trabalho.
Onde ele se destaca
Um engenheiro backend em um grande monorepo Java
Renomear um método de serviço muito usado e atualizar todos os chamadores
Com o backend de language servers, o agente consulta as referências e renomeia o símbolo em uma chamada, em vez de usar grep e corrigir texto em centenas de arquivos. É gratuito; o plugin para JetBrains passa a ser necessário quando o trabalho cresce para mover classes entre pacotes.
Um líder de equipe Python levando o Claude Code a 8 desenvolvedores
Reduzir os tokens que o agente gasta lendo arquivos inteiros
A estrutura de arquivos e a busca de símbolos permitem que o agente leia uma função em vez de um módulo de 2.000 linhas, e o Serena desativa as próprias ferramentas de arquivos e shell dentro do Claude Code para evitar duplicatas. O custo é uma instalação com uv por desenvolvedor e uma janela do painel a cada sessão, a menos que web_dashboard_open_on_launch seja desativado.
Um mantenedor de código aberto revisando pull requests externos com um agente
Navegar por código contribuído desconhecido sem expor a estação de trabalho
Rode o Serena 2.0.0 ou posterior dentro de um contêiner Docker com apenas o checkout montado, e mantenha os forks de contribuidores fora de trusted_project_path_patterns. Seu modelo de segurança parte do princípio de repositórios confiáveis, e dois avisos de 2026 mostraram que um repositório malicioso podia executar código ao ser ativado.
Antes de decidir
- Configuração
- Instale o uv, depois uv tool install -p 3.13 serena-agent e serena init; os guias de clientes cobrem Claude Code, Codex, Claude Desktop e IDEs com MCP, via stdio ou HTTP. Alguns language servers precisam ser instalados à mão; outros são baixados sob demanda, com versões fixas e verificação SHA256.
- Integrações
- Ferramentas de símbolo para encontrar, referências, estrutura, declarações, implementações, diagnósticos, renomeação e edições por símbolo, além de memórias e ferramentas opcionais de busca por regex, arquivos e shell. O plugin para JetBrains acrescenta mover, inline, hierarquia de tipos, busca de dependências e um depurador; Rider e CLion não são suportados.
- Dados e privacidade
- Roda localmente com as permissões do seu usuário e pode editar arquivos e executar comandos de shell. Dados anônimos de uso vão para a Oraios na inicialização, a menos que SERENA_USAGE_REPORTING=false, e o painel pode editar configuração e memórias a partir de localhost:24282.
- Custo em escala
- O backend de language servers é gratuito para qualquer tamanho de equipe. O plugin para JetBrains custa $5 por mês ou $50 por ano no JetBrains Marketplace, com teste de 7 dias, então uma equipe de 20 desenvolvedores paga cerca de $1.000 por ano na cobrança anual.
- Limites
- A renomeação por language server cobre só símbolos, não arquivos ou diretórios, e encontrar a declaração geralmente falha para dependências externas. Com a interface REPL, toda ação aparece como a mesma chamada de ferramenta, então a aprovação do lado do cliente não consegue distinguir uma leitura de uma escrita.
O que é bom
- Encontrar, referenciar, renomear e editar por símbolo, não por texto
- Backend gratuito de language servers cobre mais de 40 linguagens
- Funciona com Claude Code, Codex, Cursor, assistentes da JetBrains e outros
- Desenvolvimento ativo; v2.1.0 lançada em 19 de outubro de 2026
O que não é
- Três avisos de execução de código em 2026; parte do princípio de repositórios confiáveis
- Mover, inline e depuração exigem o plugin pago para JetBrains
- Painel e envio de dados de uso ativados por padrão
- Licença GPL e CLA pesam para uso embutido comercial
Ideal para
Desenvolvedores que rodam agentes de programação em bases de código grandes, tipadas ou com várias linguagens, em que confiam, e querem navegação entre arquivos e renomeações confiáveis.
Alternativas ao Serena
Serena: perguntas frequentes
- Serena vale a pena?
- As ferramentas por símbolo do Serena são um avanço real para agentes em bases de código grandes, mas seu modelo de segurança, que confia no repositório, significa que código não confiável deve ficar em um contêiner. Damos nota 4.2 de 5.
- Quanto custa Serena?
- Gratuito e de código aberto (GPL-3.0-or-later; a parte SolidLSP é MIT). O plugin opcional para JetBrains é pago, com teste gratuito de 7 dias; o JetBrains Marketplace lista $5 por mês ou $50 por ano.
- Quais são as desvantagens de Serena?
- Três avisos de execução de código em 2026; parte do princípio de repositórios confiáveis; mover, inline e depuração exigem o plugin pago para JetBrains; painel e envio de dados de uso ativados por padrão; licença GPL e CLA pesam para uso embutido comercial.
- Para quem Serena é indicado?
- Desenvolvedores que rodam agentes de programação em bases de código grandes, tipadas ou com várias linguagens, em que confiam, e querem navegação entre arquivos e renomeações confiáveis.
- Quanto custa Serena para uma equipe ou em produção?
- O backend de language servers é gratuito para qualquer tamanho de equipe. O plugin para JetBrains custa $5 por mês ou $50 por ano no JetBrains Marketplace, com teste de 7 dias, então uma equipe de 20 desenvolvedores paga cerca de $1.000 por ano na cobrança anual.
- Serena é seguro para dados da empresa?
- Roda localmente com as permissões do seu usuário e pode editar arquivos e executar comandos de shell. Dados anônimos de uso vão para a Oraios na inicialização, a menos que SERENA_USAGE_REPORTING=false, e o painel pode editar configuração e memórias a partir de localhost:24282.
- Quais são as melhores alternativas ao Serena?
- As alternativas mais próximas que analisamos são Semble, code-review-graph, GitNexus, Context7 e CodeGraph.
Respostas verificadas em 26 de out. de 2026.