OpenCode v2.2.6: MCP compartilhado, worktrees e runs arquivados

Quem roda o OpenCode em vários repositórios ao mesmo tempo sente o problema: cada projeto abre sua própria conexão para o mesmo servidor MCP, consome mais processo e demora mais para iniciar. A v2.2.6 resolve isso com pooling de conexões e adiciona dois comandos novos que ajudam em automação e em CI.

O que mudou no OpenCode v2.2.6

A release 2.2.6 do OpenCode traz cinco destaques principais. O primeiro é o compartilhamento de conexões MCP entre projetos que usam a mesma configuração. O segundo é a possibilidade de plugins de interface adicionarem temas de cores, ações em blocos de código e componentes nativos de configuração. O terceiro é um dock de compositor para celulares e tablets. O quarto é a execução de runs em worktrees do git. O quinto é o arquivamento automático de runs de CI.

Além dos destaques, a release traz melhorias no núcleo, como warming de sessão por provedor e modelo, uma política de uso para busca na web, uma VM experimental de bytecode para o Code Mode e suporte a instalações do PowerShell 7 pela Microsoft Store no Windows.

MCP compartilhado entre projetos

O compartilhamento de conexões MCP é a mudança mais útil para quem mantém vários projetos. Até agora, cada projeto abria sua própria conexão para o mesmo servidor MCP. Com a v2.2.6, basta ativar o pooling com pool: true na configuração do servidor. Todos os projetos com a mesma configuração passam a usar uma única conexão.

O resultado prático é menos processos rodando ao mesmo tempo e inicialização mais rápida. Para quem usa servidores MCP pesados, como o de busca ou o de arquivos, a economia de recursos é perceptível.

Para ativar, adicione pool: true na entrada do servidor MCP no arquivo de configuração do OpenCode. Depois, rode o OpenCode em dois projetos diferentes e confira se apenas um processo do servidor aparece. Se o servidor exigir estado por projeto, desative o pooling nesse caso.

Runs em worktree com opencode run -w

A flag --worktree, ou -w, inicia uma sessão em um worktree novo do git. Isso é útil quando você quer testar uma mudança sem tocar na árvore principal do projeto. Basta rodar opencode run -w e o OpenCode cria o worktree e começa a sessão nele.

Se quiser escolher o nome do worktree, use --worktree=. A flag não pode ser combinada com --continue nem com --session, porque a sessão nova não tem histórico anterior. Quem usa worktrees em CI pode criar um worktree por run e descartá-lo no final.

Um fluxo comum é rodar opencode run -w "crie testes para o módulo X" e deixar o agente trabalhar no worktree isolado. Se o resultado for bom, você integra a branch. Se não for, descarta o worktree sem sujar o projeto principal.

Sessões arquivadas para runs de CI

A flag --archived cria a sessão já arquivada. Runs de CI e scripts automatizados deixam de aparecer na caixa de entrada e nas listas de sessão. Sessões arquivadas também ficam ocultas na interface de terminal e são ignoradas pelo --continue.

Isso resolve um problema comum: depois de rodar dezenas de agentes em CI, a lista de sessões fica cheia de runs que ninguém vai revisar. Com --archived, esses runs ficam fora do caminho, mas ainda podem ser consultados quando necessário.

Para usar, adicione --archived ao comando opencode run. Em pipelines, combine com --format json para capturar a saída de forma estruturada. Lembre de definir timeout nos jobs de CI, porque o OpenCode agora espera os comandos de fundo, subagentes e jobs de imagem terminarem antes de sair.

Outras melhorias que valem testar

A release também muda o comportamento de opencode run em modo não interativo. Agora o comando espera os comandos de fundo, subagentes e jobs de imagem que o prompt iniciou e deixa o modelo responder aos resultados antes de encerrar. Enquanto espera, imprime waiting for N background job(s). Não há limite de tempo: um job que nunca termina, como um servidor de desenvolvimento, mantém o run aberto até você pressionar Ctrl+C ou enviar SIGTERM. Em CI, defina timeout.

O tratamento de SIGTERM também mudou. Agora o sinal cancela a sessão e os jobs de fundo e encerra com código 143. Isso torna o OpenCode mais previsível em pipelines que precisam interromper execuções.

Há ainda o warming de sessão por provedor e modelo, com modo interval: "auto" baseado no TTL do cache. E a política websearch.use para controlar o uso de busca na web. Quem quiser testar recursos experimentais pode ativar todas as flags com OPENCODE_FLAGS=all ou experimental.all_flags.

Como testar hoje

1. Atualize o OpenCode para a versão 2.2.6.
2. Em dois projetos com o mesmo servidor MCP, adicione pool: true e confira a redução de processos.
3. Rode opencode run -w "descreva a tarefa" em um repositório com git e verifique o worktree criado.
4. Rode opencode run --archived "tarefa de CI" e confira que a sessão não aparece na lista principal.
5. Em um pipeline, adicione timeout e teste o comportamento com SIGTERM.

Se você já usa o OpenCode com outros agentes, vale comparar o fluxo com o MCP server git e com o Claude Code 2.1.319, que também mexeram em MCP e segundo plano.