Cloudflare lança CLI cf para agentes de IA e anuncia fim do Wrangler

A Cloudflare abriu, em outubro de 2026, a beta pública do cf, um novo CLI open-source escrito em TypeScript↳TypeScript23 conteúdosTypeScript: ReadonlyArrayDev (Back & Front) · jun 2019Onde usar ANY no TypeScriptDev (Back & Front) · out 2025Tudo sobre o Node rodar TypeScript nativamente!Dev (Back & Front) · jul 2025Ver tudo em Dev (Back & Front) → para interagir com os serviços da empresa. Diferente do wrangler, que vinha sendo o ponto de entrada padrão para quem trabalha com Workers, D1, Hyperdrive e outros produtos da plataforma, o cf nasce desenhado para ser operado tanto por humanos quanto por agentes de IA↳Agentes de IA42 conteúdosOpera passa a integrar ChatGPT, Claude e outros agentes de IADev (Back & Front) · mar 2026Operações mais inteligentes, decisões mais rápidas: o impacto da IA agêntica na rotina de TIAI · abr 2026Adobe aposta em orquestração de agentes de IA: o que muda para devsDev (Back & Front) · abr 2026Ver tudo em AI →, segundo reportagem da InfoQ.

A ferramenta é distribuída sob licença Apache 2.0 ou MIT e usa os esquemas OpenAPI da Cloudflare como fonte de verdade. Isso permite que o cf cubra mais de 3.000 operações de API, contra aproximadamente 280 funções embutidas no Wrangler. A diferença de escala é o primeiro sinal de que não se trata de um simples reskin: é uma reconstrução da superfície de comandos a partir da documentação da API, não do código escrito manualmente por cada time de produto.

Por que criar um CLI do zero

A Cloudflare explica que o Wrangler cresceu de forma orgânica, com cada time de produto implementando sua própria experiência de comando, sem um padrão comum. Matt Taylor, gerente de produto sênior, e Samuel Macleod, engenheiro de sistemas sênior, ambos da Cloudflare, descrevem o problema:

O Wrangler foi construído manualmente, com cada time de produto contribuindo e adotando sua própria abordagem para a experiência de desenvolvimento dos comandos. Impor padrões entre os times era praticamente impossível, mesmo com nossos cerca de 280 caminhos de comando. Tínhamos terminologia inconsistente entre d1 info, hyperdrive get e workflows describe, já que cada time criou suas próprias práticas em momentos diferentes.

Wrangler was hand-built with each product team contributing and taking their own approach to their command developer experience. Enforcing patterns across teams was virtually impossible, even across our ~280 command paths. We had inconsistent terminology across d1 info, hyperdrive get, workflows describe as each team came up with their own practices at different times.Matt Taylor e Samuel Macleod, Cloudflare

Segundo os dois, manter o Wrangler como base para essa mudança esbarraria em outro problema: agentes de IA já aprenderam o comportamento do Wrangler em seus dados de treinamento. Introduzir um CLI novo evita conflitar com esse conhecimento prévio dos modelos, permitindo que o cf adote decisões de design voltadas a agentes sem as amarras de compatibilidade de uma ferramenta já estabelecida.

A padronização veio de um pipeline interno chamado Forge, a nova geração unificada de API da Cloudflare. Taylor e Macleod explicam:

Queríamos padronizar o que já tínhamos e fazer uma expansão massiva, tudo de uma vez. O Forge, nosso novo pipeline unificado de geração de API, permitiu fazer isso, partindo da ideia de gerar os comandos do CLI diretamente do esquema de API que também alimenta nossa documentação e a geração de SDKs.

We wanted to both standardize what we had and make a massive expansion, all at once. Forge, Cloudflare's new unified API generation pipeline, enabled us to do this, building on the idea of generating our CLI commands directly from the API schema that powers our API documentation and SDK generation.Matt Taylor e Samuel Macleod, Cloudflare

O que muda na prática do dev

Para quem já escreve Workers, o cf traz três mudanças concretas de workflow. Primeiro, a configuração sai do wrangler.toml ou wrangler.jsonc e passa para um arquivo cloudflare.config.ts, em TypeScript. Segundo, o Vite vira o ambiente de desenvolvimento padrão, com suporte a plugins. Terceiro, o CLI foi pensado para descoberta de comandos: em vez de decorar nomes inconsistentes entre produtos, o próprio cf ajuda a navegar os mais de 3.000 endpoints disponíveis.

A escolha por um arquivo de configuração em TypeScript, e não em TOML ou JSONC, é justificada pela Cloudflare como um ganho tanto para humanos quanto para agentes. A empresa argumenta que TypeScript oferece checagem de tipos e suporte a LSP, o que permite que um agente entenda e modifique a configuração com mais precisão do que conseguiria em formatos onde a informação de esquema é menos acessível. A configuração programática também reduziria duplicação entre arquivos.

TypeScript dividiu a comunidade

A decisão de escrever o próprio binário do CLI em TypeScript, não apenas o formato de configuração, gerou debate em uma discussão popular no Hacker News. O ponto central é previsível para quem já trabalha com ferramentas de linha de comando: startup time, portabilidade e gerenciamento de dependências de um runtime interpretado versus uma linguagem compilada. O usuário slowin resumiu a crítica:

Não entendo por que isso foi escrito em TypeScript. É um ótimo exemplo de como agentes conseguem escrever código (tenho certeza de que foram eles que escreveram o cf), mas ter conhecimento fundamental de ciência da computação continua sendo crítico. Não force seus usuários a gerenciar as dependências do seu CLI. Escreva seu CLI em uma linguagem compilada.

I don't understand why this is written in TypeScript. This is a great example of how agents can write code (I'm sure they wrote cf), yet having fundamental computer science knowledge is still critical. Do not force your users to manage the dependencies of your CLI. Do write your CLI in a compiled language.slowin, comentário no Hacker News

A crítica é relevante para quem roda CLIs em pipelines de CI/CD↳CI/CD23 conteúdosCI/CD Mobile: o caos invisível que separa times comuns de times de alta performanceDev (Back & Front) · abr 2026Lambda: implementando com GitLab CI/CD e Terraform para Integração SFTP, S3 e Databricks em GoDev (Back & Front) · nov 2023Publicando sua aplicação Web Python no WebApp do Azure e configurando o CI/CD da sua aplicaçãoDevSecOps · abr 2019Ver tudo em DevSecOps → ou em ambientes de edge com restrição de recursos: um binário Go ou Rust compilado tende a iniciar mais rápido e não depende de um runtime Node instalado na máquina. A Cloudflare não respondeu diretamente a esse ponto no material disponível, mas a defesa pública da escolha se concentrou no ganho de tipagem para configuração, não em performance de startup do próprio executável.

JSON em vez de tabela, por padrão

Outra mudança de comportamento que afeta scripts e automações: o cf retorna saída em JSON por padrão, ao contrário do Wrangler, que historicamente prioriza tabelas legíveis por humanos. Quem quiser visualização em tabela precisa pedir explicitamente. Ashish Ganda, em publicação no LinkedIn, resumiu o racional por trás da escolha:

O novo CLI cf da Cloudflare retorna JSON por padrão. Não uma tabela. Você precisa pedir a tabela. Tabelas são para olhos. JSON é para parsers.

Cloudflare's new cf CLI outputs JSON by default. Not a table. You have to ask for the table (...) Tables are for eyes. JSON is for parsers.Ashish Ganda, publicação no LinkedIn

Na prática, isso significa que agentes que invocam o cf em uma cadeia de automação recebem dados estruturados prontos para filtrar e transformar, sem precisar fazer parsing de texto tabular, algo que historicamente é frágil em scripts que dependem de saída pensada para olho humano.

O calendário de migração do Wrangler

A Cloudflare já definiu o roteiro de desativação do Wrangler. A empresa vai deprecar a ferramenta depois que a beta aberta do cf terminar, lançar uma versão major final do Wrangler que direciona os usuários para o cf, e manter 18 meses de suporte de manutenção para dar tempo de migração. Para equipes com infraestrutura de Workers em produção, isso é uma janela razoável, mas não indefinida: migrar wrangler.toml para cloudflare.config.ts e revisar scripts de CI que dependem do formato de tabela do Wrangler vira item de backlog com prazo.

O que ainda não está claro, pelo material disponível até agora, é o nível de paridade de funcionalidades entre os dois CLIs durante o período de transição, nem se times que automatizam deploy com Wrangler em pipelines legados terão um caminho de migração assistido além da documentação. Para quem mantém Workers hoje, vale acompanhar o release notes da beta antes de trocar scripts de produção.

Fonte: InfoQ