A Local Agent Browser CLI agora faz parte da Agent Browser CLI. O pacote npm
gologin-local-agent-browser-cli está obsoleto: instale gologin-agent-browser-cli e use --runtime local. Os scripts que chamam gologin-local-agent-browser continuam funcionando; veja Migrar da Local Agent Browser CLI.cloud executa as sessões no Gologin Cloud Browser. O runtime local as executa no Orbita, o navegador do Gologin, na sua própria máquina. Esta página trata do runtime local. Snapshots, refs e os demais comandos funcionam como descrito na página da Agent Browser CLI.
Quando usar local ou cloud
Requisitos
- Node.js 20 ou superior. O runtime local inicia o Orbita por meio do SDK Node.js do Gologin, que exige o Node.js 20.
- Um token de API do Gologin em
GOLOGIN_TOKEN. Veja Obter um token. - Um ID de perfil para cada sessão. Diferentemente do runtime cloud, o runtime local não cria perfis temporários.
- Orbita. Se ele ainda não estiver instalado, o SDK do Gologin o baixa para
~/.gologin/browserna primeira inicialização. Se o Orbita estiver em outro local, definaGOLOGIN_EXECUTABLE_PATH.
Instalação
gologin-agent-browserexecuta sessões de navegador na nuvem, a menos que você escolha o runtime local.gologin-local-agent-browseré um alias de compatibilidade que executa comandos no runtime local.
Escolher o runtime local
Passe--runtime local em um comando ou defina o runtime uma única vez para todo o shell:
--local e um local no início do comando também funcionam: gologin-agent-browser local open https://example.com --profile your_profile_id.
Comandos da API do Gologin, como
api, browser e proxy, sempre chamam a API diretamente, independentemente do runtime.
Variáveis de ambiente
O runtime local mantém sua configuração, a lista de perfis e o histórico de tarefas em
~/.gologin-local-agent-browser/, a mesma pasta usada pela CLI antiga.
Início rápido
--visible (ou --headed) e --headless (ou --background) escolhem o modo de janela para um único open. open-visible e open-background são atalhos para eles.
Comandos de navegador
Os comandos de sessão são os mesmos do runtime cloud:snapshot, click, type, fill, find, wait, press, scroll, tabs, cookies, storage-export, eval, screenshot, pdf, upload e outros. Veja a referência de comandos. Por enquanto, back, forward e reload funcionam apenas no runtime cloud.
find localiza um elemento na página ativa e age sobre ele em uma única etapa. Use-o quando as refs ficarem desatualizadas em páginas dinâmicas:
Comandos de perfil
Estes comandos são executados no runtime local mesmo sem--runtime local:
profile-create e profile-update aceitam um modelo por caso de uso e um proxy. --proxy-country us adiciona um proxy do Gologin; --proxy-host com --proxy-port define o seu próprio.
Runbooks e tarefas em lote
Um runbook é um arquivo JSON com uma lista de etapas da CLI:targets.json lista os perfis:
jobs e job <jobId>. --status aceita running, ok, partial ou failed:
Migrar da Local Agent Browser CLI
- Os scripts que chamam
gologin-local-agent-browsercontinuam funcionando. O comando agora vem degologin-agent-browser-cli. - Os perfis, a configuração e o histórico de tarefas em
~/.gologin-local-agent-browser/permanecem onde estão. - Para agentes de IA, instale a skill Agent Browser. Ela cobre os dois runtimes, e a skill separada Local Agent Browser está obsoleta.
Relacionado
- Agent Browser CLI — referência completa de comandos e o runtime cloud
- Gologin Web Access CLI — comandos de scraping e de navegador em uma única CLI
- AI Skills — skills para Claude Code e outros agentes
- Node.js SDK — execute perfis a partir do seu próprio código
Pacote npm
gologin-agent-browser-cli
Código-fonte
GologinLabs/agent-browser