merge

TOOLS

@@ -89,9 +89,22 @@ Este documento lista ferramentas de linha de comando (CLI) e utilitários que ot
 
 ---
 
-## 6. Instalação Rápida (Copia e Cola)
+## 6. Automação e Testes de Interface (Browser)
 
-Para instalar as ferramentas base de forma ágil e em lote, copie os blocos de comando abaixo e os rode inteiramente em seu terminal (requer `npm` e `snap` já configurados).
+### agent-browser
+- **Descrição:** CLI de automação de navegadores baseada em Rust, projetada especificamente para Agentes de IA.
+- **Por que ajuda as IAs:** Utiliza representação compacta da árvore de acessibilidade com referências determinísticas (`@e1`, `@e2`), consumindo 200–400 tokens (até 90% menos tokens que a leitura do DOM completo). Permite executar testes E2E, interagir com telas, validar fluxos e registrar evidências visuais.
+- **Modo Visível Obrigatório:** Para que o operador acompanhe cada teste em tempo real na tela, execute sempre com a flag `--headed` (ex: `agent-browser open --headed <url>`) ou defina `export AGENT_BROWSER_HEADED=true`.
+- **Instalação:**
+  - Com Bun (padrão): `bun i -g agent-browser && agent-browser install`
+  - Com NPM: `npm install -g agent-browser && agent-browser install`
+- **Documentação:** https://agent-browser.dev/
+
+---
+
+## 7. Instalação Rápida (Copia e Cola)
+
+Para instalar as ferramentas base de forma ágil e em lote, copie os blocos de comando abaixo e os rode inteiramente em seu terminal (requer `npm`, `bun` e `snap` já configurados).
 
 ### Linux (Debian / Ubuntu)
 
@@ -103,7 +116,10 @@ sudo apt-get install -y ripgrep fd-find jq shellcheck bat tree eza httpie gh
 # 2. Instalar ferramentas em Node
 npm install -g @ast-grep/cli @biomejs/biome
 
-# 3. Instalar yq via snap 
+# 3. Instalar automação de navegador para IA (visível com --headed)
+bun i -g agent-browser && agent-browser install
+
+# 4. Instalar yq via snap 
 sudo snap install yq
 ```
 
@@ -113,4 +129,5 @@ sudo snap install yq
 # Instalar utilitários essenciais
 brew install ripgrep fd ast-grep jq yq shellcheck bat tree eza httpie gh
 npm install -g @biomejs/biome
+bun i -g agent-browser && agent-browser install
 ```