Goose (Block): o agente de IA local no seu terminal

◆ Agentes Locais — Agentes que agem na sua máquina, sem nuvem · 24 € · ou todos os kits 49 € →

#O que é o Goose hoje

O Goose se apresenta como um agente de IA nativo de código aberto — aplicativo de desktop, CLI e API — para código, fluxos de trabalho e outras tarefas, escrito em Rust. O repositório (agora aaif-goose/goose) conta com cerca de 55.000 estrelas em 28 de setembro de 2026, com a versão v1.52.0 lançada em 23 de setembro de 2026.

Um ponto a corrigir se você leu apresentações mais antigas: Goose não é mais um projeto isolado da Block; agora faz parte da Agentic AI Foundation (AAIF), abrigada pela Linux Foundation. A Block continua sendo a criadora do projeto, mas a governança mudou — um detalhe importante para avaliar a continuidade do projeto antes de construir um fluxo de trabalho baseado nele.

Goose funciona com mais de 15 provedores de modelos (Anthropic, OpenAI, Google, Ollama, OpenRouter, Azure, Bedrock e outros) e se conecta a mais de 70 extensões via o protocolo aberto MCP (Model Context Protocol).

Também existe uma integração com o Ramalama, um motor local que disponibiliza modelos no formato de artefatos OCI em vez do formato proprietário do Ollama. Como sua API é compatível, o Goose pode usá-lo diretamente por meio de seu provedor Ollama, sem código específico — uma opção útil em infraestruturas já baseadas em ferramentas padrão de conteinerização (Podman, Docker), em vez de no Ollama.

#Conectar Ollama

O kit Agentes Locais

Agentes que agem na sua máquina: Cline agêntico, MCP, n8n + Ollama, automações locais.

Espaço online vitalício
PDF + arquivos
Atualizações vitalícias

O kit Agentes Locais →ou todos os kits vitalícios — 49 € →

A configuração é feita pelo assistente interativo goose configure, que solicita o provedor e depois o host. Para Ollama, se nenhum host for informado, o Goose usa localhost:11434 por padrão; o prefixo http:// é adicionado automaticamente se o esquema não for especificado.

Terminal

ollama run qwen2.5
# dans un second terminal
goose configure

Para um Ollama rodando em outra máquina da rede, é necessário definir explicitamente OLLAMA_HOST=http://{hôte}:{port} antes de iniciar a configuração. Para modelos hospedados em ollama.com em vez de localmente, o provedor a escolher é Ollama Cloud, não Ollama.

Modelo recomendado para começar

A documentação oficial utiliza qwen2.5 como exemplo de modelo a ser iniciado antes de configurar o Goose, ressaltando que ele deve ser anunciado como compatível com chamadas de ferramentas — não basta qualquer modelo de chat de uso geral.

#A armadilha do contexto de 4096 tokens

A janela de contexto padrão do Ollama é de 4096 tokens, e o Ollama trunca o conteúdo silenciosamente em vez de retornar um erro explícito. Em um agente como o Goose, que carrega instruções de projeto (.goosehints), o histórico de conversa e as definições de extensões, esse limite é atingido rapidamente.

Sintoma típico

Se o Goose ignorar seus arquivos .goosehints ou parecer perder o fio com extensões ativas, a documentação oficial aponta primeiro para esse contexto padrão curto demais, que deve ser aumentado por meio da variável de ambiente OLLAMA_CONTEXT_LENGTH antes de procurar outras causas.

Contexto ampliado

export OLLAMA_CONTEXT_LENGTH=32768

#Tool shim: corrigir a chamada de ferramentas

Certos modelos não possuem suporte nativo para chamadas de ferramentas, ou mudam durante a sessão para saída de texto bruto em vez de chamadas estruturadas. O shim de ferramenta do Goose detecta esses formatos textuais e os converte em chamadas de ferramentas executáveis. Essa é uma funcionalidade marcada como experimental pelo projeto.

Ativar o tool shim

export GOOSE_TOOLSHIM=true
ollama pull mistral-nemo

O tool shim usa um modelo interpretador separado do modelo principal de conversa — mistral-nemo por padrão via Ollama, que pode ser substituído usando GOOSE_TOOLSHIM_OLLAMA_MODEL. A documentação cita explicitamente os modelos locais (Ollama, llama.cpp) sem suporte nativo a chamadas de ferramentas como principal caso de uso, assim como os modelos que misturam tags de raciocínio (« think ») com chamadas de ferramentas, uma fonte frequente de falhas de parsing.

Um modo alternativo utiliza o backend de inferência local integrado do Goose em vez de uma instância Ollama separada, via GOOSE_TOOLSHIM_BACKEND=local e um nome de modelo obrigatório (GOOSE_TOOLSHIM_MODEL) — sem isso, a inicialização falha.

#Modos de permissão: autônomo por padrão

Goose oferece quatro modos de permissão: totalmente autônomo (modifica e remove arquivos sem confirmação), aprovação manual (pede confirmação para cada ferramenta), aprovação inteligente (aprova automaticamente ações de baixo risco) e modo somente conversa (nenhuma modificação, nenhuma ferramenta).

O modo autônomo está ativo desde a instalação

A documentação oficial esclarece sem rodeios: o modo autônomo (Autonomous Mode) está ativo por padrão. Em um computador onde o Goose tem acesso a extensões capazes de excluir arquivos ou executar comandos, mudar explicitamente de modo antes da primeira sessão é uma precaução que você não deve deixar de tomar.

Você pode mudar de modo a qualquer momento, inclusive durante uma sessão, usando /mode auto, /mode smart_approve, /mode approve ou /mode chat na CLI, ou pelo menu na parte inferior do aplicativo para desktop.

#Extensões MCP e allowlist

Goose se conecta a extensões via o protocolo MCP e instala, por padrão, qualquer servidor MCP solicitado. Para um contexto profissional, o projeto oferece uma lista de permissões: um arquivo YAML hospedado em uma URL, referenciado pela variável GOOSE_ALLOWLIST, que limita as extensões instaláveis a uma lista explícita de identificadores e comandos.

Sem essa allowlist, não há impedimento técnico para o agente instalar um servidor MCP de terceiros não verificado se o usuário (ou o modelo, em modo autônomo) fizer a solicitação — um ponto a considerar juntamente com a escolha do modo de permissão acima.

A allowlist é implantada como um simples arquivo YAML que lista pares de identificador/comando autorizados, hospedado em uma URL que o Goose relê a cada reinicialização por meio da variável GOOSE_ALLOWLIST. É uma medida pensada para implantação em empresas, nas quais um administrador deseja restringir as extensões que podem ser instaladas a uma lista validada previamente, em vez de confiar no julgamento de cada usuário ou do modelo em modo autônomo.

01
Instalar a CLI Goose
curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash, ou télécharger l'application de bureau depuis la documentation officielle.
02
Preparar o modelo Ollama
Verificar se o Ollama está rodando na porta 11434 e iniciar um modelo explicitamente anunciado como compatível com chamadas de ferramentas antes de configurar o Goose.
03
Executar goose configure
Escolher o Ollama como fornecedor, validar o host proposto por padrão (localhost:11434) e indicar o nome exato do modelo carregado.
04
Aumentar o contexto, se necessário
Se o agente ignorar extensões ou um arquivo .goosehints, definir OLLAMA_CONTEXT_LENGTH como um valor superior a 4096 antes de reiniciar uma sessão.
05
Verificar o modo de permissão
Antes da primeira sessão com extensões sensíveis, passar explicitamente para o modo de aprovação manual ou inteligente se o modo autônomo padrão não for desejado.

#Qual modelo de acordo com a memória disponível

A documentação oficial é categórica sobre um ponto frequentemente minimizado: o Goose depende fortemente de chamadas de ferramentas, e um modelo que não oferece suporte a esse recurso só pode manter conversas simples — todas as extensões do Goose devem então ser desativadas. A escolha do modelo não é, portanto, apenas uma questão de qualidade da resposta: é uma condição binária para que as extensões MCP possam sequer funcionar.

Ordem de grandeza do uso de memória (Q4, apenas os pesos) e uso realista com Goose

Tamanho do modelo	VRAM aproximada	Uso realista com extensões
7-8B	≈ 5 GB	Chamada de ferramentas instável em tarefas com várias ferramentas encadeadas; testar com GOOSE_TOOLSHIM antes de concluir que o modelo falhou
14B	≈ 9 GB	Caso de uso comum para uma estação de trabalho de desenvolvimento; verificar a tag tools em ollama.com antes de carregar o modelo
32B	≈ 19-20 GB	Mais confiável em sequências longas de ferramentas, ao custo de um tempo de geração maior em GPUs de consumo
70B	≈ 40 GB	Reservado para computadores com muita VRAM ou RAM unificada (Mac Studio, estações com múltiplas GPUs); raramente relevante para uso diário local

Essas ordens de grandeza não substituem a verificação da etiqueta tools na ficha do modelo: uma variante que não é anunciada como compatível com tool-calling falha nas extensões, independentemente do seu tamanho, exatamente como especifica a documentação oficial citada acima.

#Checklist de segurança antes de uma implantação para uso compartilhado

Três ajustes, já documentados separadamente neste guia, formam juntos a base de uma implantação do Goose mais segura do que uma instalação padrão em um computador compartilhado ou em um servidor de equipe.

Checklist antes de abrir Goose para outros usuários ou para extensões sensíveis

Ponto de controle	Ajuste a verificar
Modo de permissão	Passar de totalmente autônomo para aprovação manual ou inteligente se a exclusão de arquivos sem confirmação não for desejada
Extensões instaláveis	Definir GOOSE_ALLOWLIST para apontar para um arquivo YAML hospedado que restrinja os identificadores e comandos autorizados
Capacidade real do modelo	Confirmar a tag tools em ollama.com antes de conectar extensões; um modelo incompatível exige desativar todas elas
Contexto suficiente	Aumentar OLLAMA_CONTEXT_LENGTH para além de 4096 para evitar o truncamento silencioso das próprias instruções de segurança (.goosehints)

A lista de permissões não substitui a escolha do modo

Uma allowlist bem configurada limita as extensões instaláveis, mas não impede que um agente em modo autônomo use as extensões já autorizadas sem confirmação. Os dois ajustes se complementam; um não substitui o outro.

#Limitações de um modelo local para Goose

O que quebra primeiro com um modelo local pequeno

Sintoma	Causa provável documentada
Extensões ignoradas, instruções do .goosehints não seguidas	Contexto padrão de 4096 tokens muito curto: aumentar OLLAMA_CONTEXT_LENGTH
Chamadas de ferramentas que param durante a sessão	O modelo passa a produzir uma saída em texto: ativar GOOSE_TOOLSHIM
Interpretador lento do shim de ferramentas	Modelo interpretador muito pesado: passar para um modelo menor via GOOSE_TOOLSHIM_OLLAMA_MODEL
Raciocínio misturado com chamadas de ferramentas	Tags « think » indesejadas: o tool shim as filtra automaticamente quando é ativado

O modelo nativo DeepSeek-R1 não suporta chamadas de ferramentas segundo a documentação oficial, que propõe como alternativa uma versão comunitária adaptada para o Goose — um exemplo concreto da diferença entre um modelo considerado poderoso em conversas e sua capacidade real de controlar ferramentas.

Esse desalinhamento entre capacidade de raciocínio e confiabilidade na execução é a limitação estrutural a considerar antes de instalar o Goose localmente: um modelo que responde bem a perguntas abertas não garante nada sobre sua capacidade de encadear chamadas de ferramentas sem erros de formato. Testar primeiro uma tarefa simples e verificável — ler um arquivo, executar um comando inofensivo — antes de confiar ao agente uma tarefa em várias etapas continua sendo o meio mais rápido de identificar um modelo inadequado.

Perguntas frequentes

O Goose ainda é desenvolvido pela Block?+

A Block deu origem ao projeto, mas o Goose agora faz parte da Agentic AI Foundation, hospedada pela Linux Foundation. O repositório, inclusive, mudou de organização no GitHub, de block/goose para aaif-goose/goose — uma mudança de governança que você deve conhecer antes de construir um fluxo de trabalho de equipe baseado nele, embora a Block continue envolvida no projeto.

Por que o Goose ignora minhas extensões ou meu arquivo .goosehints com Ollama?+

A causa mais comum é o contexto padrão do Ollama, limitado a 4096 tokens e cortado silenciosamente em vez de retornar um erro explícito. A documentação oficial recomenda aumentá-lo via variável de ambiente OLLAMA_CONTEXT_LENGTH, por exemplo, para 32768, antes de procurar outra causa.

O que fazer se meu modelo local não chamar as ferramentas no Goose?+

Ativar o tool shim com GOOSE_TOOLSHIM=true. Essa funcionalidade experimental detecta chamadas de ferramentas escritas em texto simples por modelos sem suporte nativo e as converte em chamadas executáveis por meio de um modelo interpretador separado (mistral-nemo por padrão, substituível via GOOSE_TOOLSHIM_OLLAMA_MODEL). Se o modelo misturar tags de raciocínio com chamadas de ferramentas, o tool shim também filtra essas tags automaticamente depois de ativado.

Goose pode excluir arquivos sem pedir confirmação?+

Sim, por padrão: o modo totalmente autônomo, ativo desde a instalação conforme a documentação oficial, permite que o Goose modifique e remova arquivos sem aprovação. Alterar para modo de aprovação manual ou inteligente muda esse comportamento, devendo ser feito antes da primeira sessão com extensões sensíveis.

É necessária uma GPU potente para rodar o Goose localmente?+

Goose em si é um cliente leve em Rust; a maior parte da carga depende do modelo escolhido via Ollama ou outro fornecedor local. O modelo que atua como intérprete do tool shim acrescenta uma carga de inferência separada da do modelo de conversa; escolha um modelo intérprete menor se as respostas ficarem lentas.

Um modelo local sem tool-calling ainda pode ser usado com o Goose?+

Sim, mas apenas para conversar: a documentação oficial especifica que o Goose depende fortemente de chamadas de ferramentas, e um modelo que não oferece esse recurso só pode manter conversas simples; nesse caso, todas as extensões devem ser desativadas. Verificar a tag tools em ollama.com antes de carregar um modelo evita essa limitação.

Como restringir as extensões MCP que o Goose pode instalar?+

Definir a variável GOOSE_ALLOWLIST para apontar para um arquivo YAML hospedado que liste os identificadores e comandos de extensões autorizados; o Goose relê esse arquivo a cada reinicialização. É uma medida pensada para implantação em empresas, a ser combinada com um modo de permissão não autônomo, em vez de ser usada isoladamente.

Este guia ajudou você?

Um comentário, um erro ou uma observação? Avise-nos; isso ajuda a melhorar o guia para todos.

Os kits QuelLLMO guia de referência por uso

Agentes Locais Copiloto Local IA local RAG Local IA Empresarial IA Sem Filtros Mac Imagens IA

Todos os kits vitalícios — 49 €

Próximo passo lógico

Desenvolvimento · 11 min

Goose (Block): o agente IA local no seu terminal