Wrangler non basta più: nasce cf, la CLI pensata prima per gli agenti che per gli umani

Il 28 settembre 2026 Cloudflare ha rilasciato in open beta cf, una nuova interfaccia a riga di comando che sostituisce (o meglio, affianca durante la transizione) Wrangler, lo strumento storico usato per gestire Workers, Pages e l’infrastruttura Cloudflare. La differenza numerica è già indicativa della portata del cambiamento: se Wrangler copre circa 280 comandi costruiti a mano nel corso degli anni da team diversi, cf espone oltre 3.000 operazioni, generate automaticamente a partire dagli schemi OpenAPI che già alimentano la documentazione ufficiale e gli SDK.

Per chi amministra infrastrutture su Cloudflare — DNS, Workers, R2, D1, Zero Trust — questa non è solo un’estensione della superficie di comando: è un cambio di filosofia dichiarato apertamente dal team, che nel post di annuncio scrive che “gli agenti hanno bisogno di JSON, e se gli agenti sono destinati a diventare gli utenti primari di questo strumento, JSON deve essere il formato predefinito”.

La pipeline Forge: come nascono 3.000 comandi senza impazzire

Il motore dietro cf si chiama Forge, una pipeline di generazione che Cloudflare ha reso open source e che converte gli schemi OpenAPI in comandi CLI con un’annotazione minima aggiuntiva. È lo stesso principio con cui oggi vengono generati gli SDK ufficiali e la documentazione API: unificando la fonte di verità, Cloudflare ha potuto standardizzare comandi storicamente incoerenti tra team diversi e, allo stesso tempo, ampliare drasticamente la copertura dell’API.

Il risultato pratico più citato nel post ufficiale è la riduzione della complessità di configurazione: alcuni file Wrangler usati internamente da Cloudflare, che superavano le 5.000 righe, si sono ridotti del 40% passando al nuovo formato.

Installazione e primi comandi

L’installazione avviene via npm, come per Wrangler:

npm i -g cf

I comandi principali per iniziare un progetto ricalcano un flusso familiare:

# Avvia un nuovo progetto Hello World
cf init

# Effettua il deploy di siti statici o Worker
cf deploy

# Converte un progetto Wrangler esistente
cf migrate

La novità più interessante per chi lavora con agenti AI è cf cli search, un comando pensato per la scoperta in linguaggio naturale tra le oltre 3.000 operazioni disponibili: invece di dover ricordare a memoria (o far ricordare al modello) migliaia di sottocomandi, l’agente interroga cf cli search con una descrizione dell’obiettivo e riceve indicazioni mirate, senza dover caricare nel contesto l’intero elenco dei comandi disponibili — un dettaglio non banale quando si lavora con finestre di contesto limitate.

Configurazione TypeScript al posto del TOML

Un cambiamento che avrà un impatto diretto sul lavoro quotidiano degli sviluppatori è l’abbandono del formato TOML di Wrangler in favore di file cloudflare.config.ts scritti in TypeScript, con type-checking e supporto LSP nativo nell’editor:

import { defineConfig, bindings, triggers } from "cf/config";

export default defineConfig({
  name: "my-worker",
  bindings: bindings({
    kv: "MY_KV_NAMESPACE",
    d1: "MY_DATABASE",
    r2: "MY_BUCKET",
  }),
  triggers: triggers({
    fetch: true,
    scheduled: "0 */6 * * *",
  }),
});

L’helper bindings fornisce il completamento automatico per variabili d’ambiente, storage KV, database D1, bucket R2, code (Queues) e i binding worker-to-worker, mentre triggers consolida in un unico punto i trigger di tipo fetch, scheduled, queue ed email. Per un team che gestisce decine di Worker, il vantaggio del type-checking in fase di scrittura — piuttosto che scoprire un errore di configurazione solo al deploy — non è un dettaglio marginale.

Vite al posto di esbuild

Un’altra scelta tecnica degna di nota è l’adozione di Vite come build system predefinito, al posto di esbuild usato da Wrangler. Questo porta hot module replacement e un ecosistema di plugin più maturo per chi sviluppa applicazioni complesse su Workers, anche se i progetti JavaScript Workers che già usano configurazioni esbuild personalizzate continueranno temporaneamente a delegare a Wrangler durante la fase di transizione.

Perché JSON-first cambia le regole del gioco

Dal punto di vista di un sistemista abituato a Wrangler, uno dei cambiamenti più tangibili riguarda l’output dei comandi. Wrangler restituiva tabelle Unicode pensate per la lettura umana, che spesso richiedevano il filtraggio con jq per essere processate in script di automazione. cf inverte la priorità: l’output è JSON per default (con pretty-print quando il terminale è interattivo), pensato in primo luogo per il consumo programmatico da parte di agenti e pipeline CI/CD, e solo secondariamente per la lettura diretta.

Per le operazioni complesse — l’esempio citato nel post ufficiale è l’acquisto di un dominio, che richiede numerosi parametri interdipendenti — cf scompone il flusso in input sequenziali validati, mantenendo la possibilità di eseguirlo sia in modalità interattiva (per un umano) sia in modalità completamente programmatica (per uno script o un agente).

Roadmap di migrazione da Wrangler

Cloudflare ha dichiarato che Wrangler riceverà supporto di manutenzione per 18 mesi dopo la fine della fase beta di cf, un periodo di transizione sufficientemente ampio per pianificare la migrazione senza fretta. Il comando cf migrate automatizza la conversione dei progetti esistenti, ma vale la pena, prima di lanciarlo su repository di produzione, verificare manualmente i binding e i trigger generati, specialmente per configurazioni Wrangler complesse costruite nel tempo da più persone.

Conclusione

Il lancio di cf segna un punto di svolta interessante per chi gestisce infrastruttura su Cloudflare: non è semplicemente “Wrangler con più comandi”, ma una CLI ripensata da zero attorno all’idea che l’utente principale, in un futuro ormai prossimo, sarà un agente AI e non una persona davanti al terminale. Per i team DevOps italiani che già usano Cloudflare per Workers, DNS o Zero Trust, vale la pena iniziare a sperimentare cf in ambienti di test non appena possibile: la finestra di 18 mesi di coesistenza con Wrangler è generosa, ma la configurazione TypeScript e l’output JSON-first sono vantaggi concreti anche per chi non usa ancora agenti AI nella propria toolchain quotidiana.

Fonte: Cloudflare Blog – Introducing cf: the agentic CLI for the entire Cloudflare API.