A Cloudflare apresentou a versão beta aberta do cf, uma nova interface de linha de comando (CLI) de código aberto e focada em agentes de IA para interagir com os serviços da Cloudflare através de uma CLI unificada. Escrita em TypeScript, oferece saída estruturada e descoberta de comandos para tornar as APIs da Cloudflare mais acessíveis tanto para desenvolvedores quanto para agentes de IA.
Por que uma nova CLI?
A empresa argumenta que introduzir uma nova ferramenta evita conflitos com o comportamento aprendido pelos modelos de linguagem em torno do Wrangler, permitindo ao cf adotar mudanças focadas em agentes sem as restrições de compatibilidade de uma ferramenta consolidada.
Matt Taylor, gerente sênior de produtos da Cloudflare, e Samuel Macleod, engenheiro sênior de sistemas da Cloudflare, explicam a necessidade:
"Wrangler foi construído manualmente com cada equipe de produto contribuindo e adotando sua própria abordagem para a experiência do desenvolvedor. Impor padrões entre equipes era virtualmente impossível, mesmo considerando nossos ~280 caminhos de comando. Tínhamos terminologia inconsistente entre d1 info, hyperdrive get, workflows describe, já que cada equipe desenvolveu suas próprias práticas em momentos diferentes."
Características principais
Lançado sob licença Apache 2.0 ou MIT, o cf CLI é projetado para desenvolvimento orientado por agentes, oferecendo:
- Descoberta de comandos automática
- Saída JSON otimizada tanto para humanos quanto para agentes
- Novo formato de configuração baseado em TypeScript: cloudflare.config.ts
- Vite como ambiente de desenvolvimento padrão, proporcionando experiência local consistente e suporte a plugins
Usando esquemas OpenAPI da Cloudflare como fonte, o cf pode cobrir mais de 3.000 operações de API, em comparação com aproximadamente 280 funções incorporadas ao Wrangler. Taylor e Macleod acrescentam:
"Queríamos tanto padronizar o que tínhamos quanto fazer uma expansão massiva, tudo ao mesmo tempo. Forge — o novo pipeline de geração de API unificado da Cloudflare — nos permitiu fazer isso, construindo sobre a ideia de gerar nossos comandos de CLI diretamente do esquema de API que alimenta nossa documentação de API e geração de SDK."
Reações da comunidade
Em uma popular thread do Hacker News, a reação da comunidade focou particularmente na escolha do TypeScript para uma CLI, com discussões sobre tempo de inicialização, portabilidade e gerenciamento de dependências. Um usuário comentou:
"Não entendo por que isso foi escrito em TypeScript. Este é um ótimo exemplo de como agentes podem escrever código, mas ainda ter conhecimento fundamental de ciência da computação é crítico. Não force seus usuários a gerenciar as dependências de sua CLI. Escreva sua CLI em uma linguagem compilada."
A Cloudflare argumenta que TypeScript facilita a configuração tanto para humanos quanto para agentes ao fornecer segurança de tipos e suporte LSP, permitindo que agentes entendam e modifiquem configurações com mais precisão. Os autores contrastam isso com TOML e JSONC, onde informações de esquema são menos acessíveis aos agentes, e observam que a configuração programática também pode reduzir duplicação de configuração.
JSON como padrão
A Cloudflare faz do JSON o formato de saída padrão, permitindo que agentes filtrem e transformem a saída para o formato exigido pelos usuários humanos, evitando o formato de tabela usado por padrão no Wrangler.
Transição do Wrangler
A empresa planeja depreciar o Wrangler após o término da beta aberta do cf, lançar uma versão principal final do Wrangler direcionando usuários para cf, e fornecer 18 meses de suporte de manutenção para permitir migração.
