TabbitBlog

Agweb Browser: recursos, requisitos e limites

Entenda o paul-nameless/agweb, a janela WebKit que não toma foco, o CLI, os requisitos do macOS e quando ainda usar Playwright.

Neste artigo
  1. Principais pontos
  2. Agweb em resumo
  3. O agente trabalha, mas a janela continua visível
  4. Para quem serve e para quem não serve
  5. Instale apenas se o Mac e as ferramentas forem compatíveis
  6. Os limites fazem parte da decisão
  7. Outra opção quando o navegador é parte do trabalho
  8. Conclusão

Se a automação do navegador traz a janela para a frente do editor, vale conhecer o projeto paul-nameless/agweb. O README o descreve como um navegador visível para macOS, controlado por agentes via shell sem colocar a janela em primeiro plano. No Show HN, uma pessoa que testa seus próprios aplicativos web disse que a perda de foco durante os testes tinha virado “um problema de verdade”. Esse comentário mostra a necessidade. A ideia de que o Agweb a resolve vem do mantenedor, não de uma medição feita neste artigo. Comentário no Show HN

Primeiro, vale esclarecer o nome. Este artigo é sobre github.com/paul-nameless/agweb, um navegador de código aberto para agentes de programação. Não é o AgWeb.com, site de notícias agrícolas e mercados, nem um framework genérico de automação. É um app específico para macOS com controle por linha de comando.

O painel do Agweb mostra seis abas de agentes e os espaços de trabalho na barra lateral
Captura do painel incluída no README do projeto Agweb.

Principais pontos

  • O Agweb é um navegador de desktop visível baseado em WebKit. O mantenedor afirma que as ações do agente não trazem a janela para a frente.

  • Em 16 de novembro de 2026, v0.3.0 era a versão mais recente visível no GitHub. Ela exige macOS 26 ou posterior; o mantenedor diz que só testou no macOS 26.

  • Cada agente pode ter um espaço de trabalho para suas abas. Agentes que usam o mesmo perfil nomeado compartilham o login.

  • O Agweb não oferece CDP. Playwright e extensões do Chrome não se conectam, e alguns sites exclusivos do Chrome podem apresentar problemas.

  • Pode fazer sentido em tarefas locais no Mac quando você quer ver as abas dos agentes e seguir usando outra janela. Se precisa de compatibilidade Chrome, CDP, extensões, headless ou servidor, escolha outra ferramenta.

Agweb em resumo

PerguntaO que o projeto documentaO que isso significa
O que é?Navegador macOS baseado em WebKit, controlado pelo comando shell agweb.App e CLI formam um fluxo local, não uma API de navegador hospedada.
O que significa “em segundo plano”?A janela fica visível; o mantenedor diz que não toma foco. Cmd+D abre o painel com as abas dos agentes.Você pode seguir em outro app, mas o navegador continua visível e usa recursos locais.
Como os agentes se organizam?Cada agente tem seu espaço e suas abas; vários podem compartilhar um perfil nomeado.O espaço organiza abas. Cookies e logins são compartilhados por perfil.
Qual é o principal limite de compatibilidade?WebKit apenas, sem Chrome DevTools Protocol.Playwright e extensões do Chrome não se conectam. Teste os sites de que precisa.
Qual sistema exige?macOS 26 ou posterior.A página não documenta pacotes para Windows ou Linux.

O agente trabalha, mas a janela continua visível

O Agweb é uma janela real de navegador. O README afirma que ela não vai para a frente quando o agente atua e que Cmd+D mostra as abas de cada espaço. “Em segundo plano” significa que você pode continuar usando o editor ou outro app. Não significa que o Agweb seja um processo oculto sem interface.

O comando shell abre páginas e retorna um snapshot. O README mostra este exemplo:

agweb -w task open en.wikipedia.org/wiki/WebKit
agweb -w task snapshot

A primeira linha abre a página no espaço task; a segunda retorna uma árvore da página com referências aos elementos. O README diz que as ações mostram o que mudou. A versão v0.3.0 também melhora o clique em elementos cobertos: a ação falha e identifica o elemento sobreposto, a menos que o chamador use --force. Consulte a saída atual de agweb help para ver todos os comandos. README oficial · Notas da versão v0.3.0

Ver a janela não prova que o agente usou a conta certa, escolheu o item correto ou concluiu uma alteração. Confira o resultado na página antes de confiar no resumo. O guia Browser MCP ou CLI explica como o tipo de conexão muda o fluxo.

Para quem serve e para quem não serve

O Agweb merece ser avaliado quando um agente local de programação precisa de um navegador visível e você quer continuar usando o Mac. Ele não é adequado para automações dependentes de interfaces internas do Chrome ou que precisam rodar em um servidor Linux remoto.

Sua condiçãoAdequação do AgwebPróximo passo
Você usa macOS 26+ e quer ver as abas de vários agentes sem trocar de janela.É o fluxo descrito no README.Teste primeiro em um site sem dados sensíveis.
Seus testes precisam de CDP ou de uma extensão do Chrome.Não serve. O README diz que nenhum dos dois pode se conectar.Mantenha um ambiente Chrome compatível com CDP. No Show HN, uma pessoa disse que sem CDP o projeto não atendia seu fluxo. Comentário
O site de destino só funciona corretamente no Chrome.Incerto. O projeto avisa que alguns sites podem falhar.Teste o site e o fluxo exatos ou use Chrome.
Você precisa de navegador headless, worker na nuvem ou container Linux.Não documentado. O Agweb é apresentado como app visível para macOS.Use um serviço ou ferramenta feita para esse ambiente.
Cada agente precisa de uma identidade de login diferente.Separar espaços não basta. O mesmo perfil compartilha logins.Crie perfis separados e confirme o que é compartilhado antes de entrar.

Por isso, “um espaço por agente” não quer dizer “uma identidade de navegador isolada por agente”. No HN, uma pessoa pediu um ambiente paralelo que não bloqueasse quem está usando o computador. Esse é um requisito útil, mas não prova que o Agweb isole cookies ou identidade de rede. O README diz que agentes com o mesmo perfil compartilham os logins. Comentário no HN

Instale apenas se o Mac e as ferramentas forem compatíveis

A versão v0.3.0 exige macOS 26 ou posterior e não lista pacotes para Windows ou Linux. O mantenedor afirma que macOS 26 é a única versão testada. O app abrir em um macOS mais antigo não garante compatibilidade.

O caminho documentado é baixar o DMG em GitHub Releases, mover o Agweb para Applications e abrir o app. Depois, escolha Help → Install Command Line Tool e Help → Install Agent Skill. O README diz que a Skill é para Claude Code e Codex. Compilar do código-fonte é opcional e exige Xcode 26 ou posterior. Se você só quer entender o fluxo, não precisa instalar primeiro. Passos da versão

Antes de entrar numa conta de trabalho, escolha qual perfil o agente deve usar. O README diz que um perfil nomeado mantém o login e é compartilhado por todos os agentes que o usam. Os espaços separam abas, mas não garantem cookies separados. No HN, alguém queria usar os cookies da sessão principal e, ao mesmo tempo, executar tarefas paralelas sem ser interrompido. Trate isso como preferência e confira as regras da sua equipe. Discussão no HN · Perfis, espaços e grupos de abas

Na primeira execução, use uma página pública e uma tarefa curta: abrir uma URL, ler o título e uma seção específica, e indicar o que não conseguiu confirmar. Se a página mudar, tire um novo snapshot antes de agir. Consulte a lista da primeira tarefa de agente de navegador e o tutorial do CLI agent-browser.

Os limites fazem parte da decisão

A principal fronteira técnica é o WebKit. O README diz que não há CDP, então Playwright e extensões do Chrome não podem se conectar. Uma pessoa no Show HN disse que isso tornava o Agweb inútil para seu caso. A resposta do mantenedor foi direta: o Agweb usa WebKit; para CDP, use Playwright. Discussão no Show HN

O README também avisa que alguns sites exclusivos do Chrome podem falhar. As ferramentas de rede são limitadas: route simula fetch e XHR; requests lista apenas URLs de recursos. O bloqueador usa listas baixadas, mas não executa scripts do uBlock e pode deixar passar páginas que pedem para desativá-lo. Se o agente precisa testar um pagamento ou um site com checagens rígidas, confirme o fluxo específico. Abrir uma página comum não prova que o site inteiro é compatível.

O README inclui uma comparação de memória com cinco páginas ociosas. Esse dado foi publicado pelo mantenedor e não é um benchmark independente deste artigo. O uso varia conforme páginas, hardware e tarefa. Não instalamos Agweb nem testamos sua compatibilidade, foco ou consumo de recursos.

Outra opção quando o navegador é parte do trabalho

O Agweb é voltado a quem quer um navegador visível dedicado aos agentes. Outras pessoas preferem que um agente local compatível trabalhe pelo navegador que já usam para pesquisa, login e revisão manual. O Tabbit Browser tem seu próprio fluxo CLI para clientes compatíveis, com abas de tarefa e contexto do navegador. É uma abordagem diferente; não significa WebKit, CDP ou o mesmo comportamento de foco. Leia o guia do Tabbit CLI e a configuração do Codex para verificar se o cliente é compatível.

Se você ainda compara como deixar o agente navegar enquanto continua trabalhando, veja automação de navegador em segundo plano e o guia de agentes de automação de navegador. Os guias sobre como deixar agentes de IA controlarem o navegador e conectar um agente ao navegador existente cobrem a categoria geral; este artigo trata das escolhas específicas do Agweb.

Conclusão

O Agweb responde a uma irritação concreta: uma janela de navegador pode interromper quem está executando um agente. Seu painel visível, comandos shell e espaços por agente são voltados ao uso local no Mac. As limitações também são claras: macOS 26+, WebKit, sem CDP, compatibilidade incerta com alguns sites de Chrome e login compartilhado dentro do mesmo perfil nomeado.

Antes de instalar, confira na página da versão os requisitos de macOS e CDP. Se forem adequados, comece por uma página pública, confira o snapshot e o resultado e só então decida se usará um perfil autenticado. O guia geral de controle de navegador por agentes é uma boa próxima leitura.

Perguntas frequentes

Agweb é o mesmo site que AgWeb.com?

Não. AgWeb.com é um site de notícias agrícolas e mercados de commodities. Este artigo fala sobre paul-nameless/agweb, um navegador de código aberto para agentes de programação no macOS.

Qual versão do macOS o Agweb exige?

A versão v0.3.0 exige macOS 26 ou posterior, e o mantenedor afirma que testou apenas no macOS 26. A página da versão não documenta um build para Windows ou Linux.

O Agweb funciona sem interface em segundo plano?

A documentação descreve uma janela de desktop visível com um painel. O projeto foi pensado para não trazer a janela para a frente durante o trabalho do agente; isso não é o mesmo que um serviço headless documentado.

É possível conectar Playwright ao Agweb?

Não. O Agweb usa WebKit e, segundo o README, não oferece Chrome DevTools Protocol. Por isso, Playwright e extensões do Chrome não podem se conectar. Se seu fluxo depende dessas interfaces, use um navegador compatível com CDP.

Os espaços de trabalho dos agentes são isolados?

Os espaços agrupam as abas de cada agente, mas agentes que usam o mesmo perfil nomeado compartilham o estado de login. Um espaço não é um cookie jar nem uma identidade separada.

Como instalar o Agweb?

Baixe o DMG nas versões oficiais do GitHub, mova o Agweb para Applications e abra o app. Depois use Help para instalar a ferramenta de linha de comando e a Skill do agente; compilar do código-fonte é outra opção e exige Xcode 26 ou posterior.

Dê o próximo passo

Deixe o Tabbit trabalhar ao seu lado.

Pesquise entre abas, automatize o trabalho repetitivo do navegador e mantenha todo o contexto ao alcance.