Cloudflare estreia CLI cf com acesso a mais de 3.000 operações da API

Cloudflare lança a CLI cf, que dá aos agentes acesso a toda a API

A Cloudflare anunciou o cf, uma nova interface de linha de comando em beta aberto criada para o desenvolvimento dirigido por agentes de IA, instalável globalmente com npm i -g cf. A motivação vem do crescimento acentuado do uso de agentes: em março de 2026, agentes eram responsáveis por um quarto do uso do Wrangler, contra percentuais de um dígito no ano anterior; na semana passada, chegaram a 48%. Agentes também usam quase o dobro de comandos distintos por dia e têm quase quatro vezes mais probabilidade de usar seis ou mais comandos.

O problema é que o Wrangler, CLI anterior, cobre cerca de 280 operações, enquanto a Cloudflare oferece milhares. O cf expande a cobertura para mais de 3.000 operações, permitindo que um agente configure e deploye um Worker, monitore-o, proteja-o com Cloudflare Access, compre um domínio e o coloque atrás do WAF - tudo por uma única ferramenta.

Geração unificada a partir do schema da API

O Wrangler era construído manualmente, com cada equipe de produto contribuindo com abordagens próprias, o que gerava terminologia inconsistente (como d1 info, hyperdrive get e workflows describe) e experiências customizadas raramente usadas. Para padronizar e expandir ao mesmo tempo, a Cloudflare usou o Forge, seu novo pipeline unificado de geração de API: como todos os produtos têm schema OpenAPI, basta anotá-lo para que o Forge gere os comandos do CLI a partir do mesmo schema que alimenta a documentação e os SDKs.

Design para agentes que nunca usaram cf

Apesar de introduzir uma CLI inédita parecer disruptivo, a empresa argumenta que é a opção mais limpa: mudanças drásticas no Wrangler conflitariam com o comportamento aprendido por LLMs treinados em anos de documentação. Uma ferramenta nova permite injeções de contexto e arquivos AGENTS.md pensados para agentes desde o início.

Entre as decisões de design:

• JSON como padrão: no Wrangler, agentes acrescentavam --json (não suportado por todos os comandos) e filtravam com jq. No cf, JSON é o padrão - formatado para humanos e condensado para agentes, economizando contexto. Para tarefas que exigem input humano, como comprar um domínio, o cf decompõe os requisitos da API em formulários de entradas validadas.
• Descoberta de comandos: o cf cli search permite que o agente descreva em linguagem natural o que quer fazer, e um índice de busca pequeno retorna os comandos adequados, com base nas descrições e parâmetros da API. O comando é revelado automaticamente ao agente na primeira execução de --help.
• Configuração tipada: o novo formato cloudflare.config.ts é baseado em TypeScript, o que ajuda agentes com plugins LSP (como Claude Code e Codex) a fazer sugestões mais precisas - em contraste com o TOML, sem schema acessível, e o JSONC, cujo schema os agentes raramente usavam. Arquivos de configuração internos da Cloudflare foram reduzidos em até 40%, de mais de 5.000 linhas, ao definir ambientes programaticamente a partir de uma base universal em vez de copiar blocos env. Helpers como bindings (para variáveis, storage, D1, R2, filas, IA e Vectorize) e triggers (rotas, schedules, filas e e-mail em um único bloco) acompanham o formato, com migração via cf migrate.

Vite como padrão e destino do Wrangler

Quando o Wrangler começou a suportar JavaScript Workers, o Vite não existia, e a Cloudflare usou esbuild e um dev server próprio em :8787 baseado no Miniflare. O cf adota o Vite como padrão, trazendo o Cloudflare Vite Plugin, dev server com HMR, builds com o Rolldown (biblioteca em Rust) para tree-shaking e integração com o plugin Vitest.

Workers que ainda dependem do esbuild, além de Workers em Rust e Python, continuarão delegando build e deploy ao Wrangler durante a transição. Quando o beta aberto terminar, a Cloudflare lançará uma versão final do Wrangler que direciona usuários e agentes ao cf, com suporte de manutenção por 18 meses após o fim do beta. Novos projetos podem ser inicializados com cf init/deploy, que instala o plugin Vite e cria a configuração; sites estáticos continuam dispensando arquivo de configuração e podem ser publicados com cf deploy.

O cf é open source, com issues aceitas no repositório do GitHub da empresa. A visão declarada é que o cloudflare.config.ts se torne a forma de gerenciar a Cloudflare como um todo, permitindo em breve configurar políticas, zonas e DNS por configuração typesafe.