O que é only-cli (oc)?
only-cli, executado como `oc`, é uma ferramenta de linha de comando em Node.js para agentes de código. `oc open <url>` busca uma página e imprime uma visão de texto compacta com links e regiões numerados; `oc do 3` segue o link 3, e `oc find`, `oc read` e `oc next` percorrem o resto sem buscar a página de novo. As requisições se passam pelo Chrome por meio da biblioteca impers e, se necessário, recorrem ao Firefox e depois a um fetch simples.
Além da renderização genérica, traz atalhos para dezenas de sites, entre eles Hacker News, GitHub, Stack Overflow, Wikipedia, npm, PyPI e a documentação de Python, MDN e Node.js; vários leem um feed ou uma API JSON pública em vez da página. Instala pelo npm, como plugin do Claude Code ou como skill de agente, e tem licença MIT.
only-cli (oc) vale a pena?
oc ataca o custo certo. Quando um agente de código busca uma página, quase tudo o que entra no contexto é marcação; o oc devolve algumas centenas de tokens no lugar. O teste do próprio projeto, feito com oc 0.5.1 a 0.5.3 em setembro de 2026 em sites reais, chega a 9.466 tokens para catorze páginas com oc contra 1.119.003 em HTML bruto, cerca de 118 vezes menos, e 17 vezes menos que o Jina Reader. Em execuções completas com Claude Code, cinco consultas à Wikipedia custaram $0.23 com `oc wiki` contra $0.45 com o WebSearch embutido, e doze perguntas sobre dependências tiveram 12 de 12 respostas certas por $0.63, contra 10 de 12 por $0.70 com WebFetch.
O design mantém pequeno o trabalho do agente. Cada visão termina com uma linha que lista as próximas ações, então o agente aprende os comandos pela própria saída; o orçamento padrão é de 500 tokens por página, e uma página que passa só um pouco disso é impressa inteira. Quando uma página não tem texto legível, como um app só em JavaScript ou um desafio antibot, o oc sai com o código 2 em vez de devolver uma visão vazia, para que o agente saiba quando vale pagar por um navegador de verdade. O README não exagera: com o Codex, a busca do próprio agente superou o oc em 16% nas consultas de documentação.
O porém: o oc é jovem e só lê. O repositório foi criado em agosto de 2026, tem 707 estrelas e é mantido sobretudo por uma conta; a versão 0.5.10 saiu em 17 de novembro. `fill` e `submit` aparecem na lista, mas não estão implementados, não há renderização de JavaScript, e sites com desafios antibot rígidos ainda podem recusá-lo. O acesso a sites que bloqueiam buscas simples depende de imitar a impressão digital de rede do Chrome, o que os termos de alguns sites proíbem. A navegação com login funciona passando os cookies do seu navegador para `oc login`; eles ficam em `~/.only-cli/sessions/` com permissão só para o dono, expiram por padrão depois de uma hora e só são enviados por HTTPS, mas continuam sendo credenciais válidas no disco. O oc recusa endereços privados e internos, e o README avisa que o texto de uma página pode conter instruções que um agente não deve seguir. O comando também se chama `oc`, como a CLI do Red Hat OpenShift.
Nossa opinião: para um agente que passa o dia lendo documentação, registros de pacotes e fóruns, o oc é um substituto barato do WebFetch com pouco a perder; tudo o que exige clicar por um app em JavaScript continua sendo trabalho para um navegador headless como o Lightpanda.
Onde ele se destaca
Um desenvolvedor backend que usa Claude Code em um serviço com Python e Node.js
Consultar APIs de bibliotecas e versões de pacotes sem encher a janela de contexto
Adicione uma linha ao CLAUDE.md para o agente rodar `npx @only-cli/oc open <url>`, ou instale a skill web-browsing-cli. Atalhos como `oc py library json` e `oc npm pkg react` devolvem algumas centenas de tokens; o teste de dependências do autor custou $0.63 por 12 perguntas contra $0.70 com WebFetch.
Uma engenheira de plataforma analisando um alerta de dependência
Verificar o aviso de segurança, as versões do pacote e a data de fim de suporte em uma única sessão do agente
`oc osv vuln <id>`, `oc gh releases <owner> <name>` e `oc eol product <name>` consultam cada um uma API pública e imprimem os campos que importam. A API de avisos do GitHub permite 60 requisições por hora sem token.
Um engenheiro cuja wiki da equipe é um SaaS hospedado atrás de login único
Deixar um agente ler páginas que ele não alcança de forma anônima
Passe o cabeçalho Cookie do navegador para `oc login --cookie - --domain <wiki host> --expires 2h` e depois use `--session` com `oc open`. Os cookies ficam em um arquivo só do dono e são apagados por `oc logout`. O oc recusa endereços privados e internos, então hosts de intranet ficam fora do alcance.
Antes de decidir
- Configuração
- `npm install -g @only-cli/oc` com Node 20 ou mais recente, ou `npx @only-cli/oc` sem instalar. Também há um plugin do Claude Code (`/plugin marketplace add only-cli/oc`) e uma skill de agente.
- Integrações
- Claude Code, Codex, Cursor, Copilot e outros agentes via skill ou uma linha de instrução; proxies HTTP e HTTPS pelas variáveis de ambiente de sempre; saída `--json` para scripts.
- Dados e privacidade
- Roda localmente, sem conta. O estado das páginas e os cookies ficam em `~/.only-cli` (altere com `OC_HOME`); os arquivos de cookies têm modo 0600, expiram por padrão depois de uma hora e guardam no máximo 50 cookies. Endereços privados e internos são recusados.
- Custo em escala
- Gratuito sob MIT; a economia está nos tokens do modelo, cerca de 1.100 a 1.200 tokens novos de entrada por tarefa nas execuções com Claude Code do autor.
- Limites
- Sem renderização de JavaScript nem formulários; o Reddit recusa uma segunda requisição anônima de feed em cerca de 30 segundos; `ALL_PROXY` e proxies SOCKS não são suportados; alvos IPv6 literais falham através de um proxy HTTPS.
O que é bom
- Cerca de 118 vezes menos tokens que o HTML bruto no teste de 14 páginas do autor
- Um código de saída próprio para páginas vazias diz ao agente quando recorrer a um navegador
- Atalhos para GitHub, npm, PyPI, Stack Overflow e os principais sites de documentação
- Licença MIT, sem daemon; roda via npx ou como plugin do Claude Code
O que não é
- Só leitura: preencher e enviar formulários não está implementado
- Sem renderização de JavaScript, e desafios antibot rígidos ainda podem bloqueá-lo
- Os testes são do próprio autor; projeto jovem com um único mantenedor principal
- Imitar o Chrome pode violar os termos de alguns sites; `oc` conflita com a CLI do OpenShift
Ideal para
Desenvolvedores cujos agentes de código leem documentação, registros de pacotes e fóruns o dia inteiro e querem cortar os tokens e o custo de cada consulta.
Alternativas ao only-cli (oc)
only-cli (oc): perguntas frequentes
- only-cli (oc) vale a pena?
- oc reduz em uma ordem de grandeza o que um agente de código paga para ler uma página web, segundo os testes do autor, mas só lê: ainda não lida com páginas em JavaScript nem com formulários. Damos nota 3.8 de 5.
- Quanto custa only-cli (oc)?
- Gratuito e de código aberto sob a licença MIT; sem conta, serviço hospedado ou plano pago.
- Quais são as desvantagens de only-cli (oc)?
- Só leitura: preencher e enviar formulários não está implementado; sem renderização de JavaScript, e desafios antibot rígidos ainda podem bloqueá-lo; os testes são do próprio autor; projeto jovem com um único mantenedor principal; imitar o Chrome pode violar os termos de alguns sites; `oc` conflita com a CLI do OpenShift.
- Para quem only-cli (oc) é indicado?
- Desenvolvedores cujos agentes de código leem documentação, registros de pacotes e fóruns o dia inteiro e querem cortar os tokens e o custo de cada consulta.
- Quanto custa only-cli (oc) para uma equipe ou em produção?
- Gratuito sob MIT; a economia está nos tokens do modelo, cerca de 1.100 a 1.200 tokens novos de entrada por tarefa nas execuções com Claude Code do autor.
- only-cli (oc) é seguro para dados da empresa?
- Roda localmente, sem conta. O estado das páginas e os cookies ficam em `~/.only-cli` (altere com `OC_HOME`); os arquivos de cookies têm modo 0600, expiram por padrão depois de uma hora e guardam no máximo 50 cookies. Endereços privados e internos são recusados.
- Quais são as melhores alternativas ao only-cli (oc)?
- As alternativas mais próximas que analisamos são OpenCLI, Lightpanda e Crawl4AI.
Respostas verificadas em 18 de nov. de 2026.