Η νέα CLI cf του Cloudflare: πρόσβαση σε ολόκληρο το API με agent‑centric design

Εισαγωγή: τα όρια του Wrangler και η ανάγκη για unified CLI

Το Wrangler είχε φτιαχτεί χέρι‑σε‑χέρι από τις διαφορετικές ομάδες προϊόντων, με αποτέλεσμα να υπάρχει ασυνέπεια στην ορολογία και στην υλοποίηση των εντολών. Αν και τα agents είχαν αυξήσει τη χρήση του Wrangler από μονάdigit ποσοστό έως το 48 % του συνολικού traffic, οι περιορισμοί του (~280 εντολές) και η uniformità των command‑developer experiences έκαναν evidente την ανάγκη για μια πιο πλατφόρμα.

Η λύση kwam από το Forge, το νέο pipeline που δημιουργεί κώδικα straight από το OpenAPI schema που υποκείται στην τεκμηρίωση και τα SDKs. Με αυτή τη μέθοδο, η cf καλύπτει όλο το επιφανειακό εμβαδόν του Cloudflare API – πάνω από 3.000 λειτουργίες – χωρίς χρειάζεται χειροκίνητη συντήρηση.

Η αρχιτεκτονική του cf: Forge, JSON default και TypeScript ρυθμίσεις

Η cf είναι σχεδιασμένη ώστε η JSON να είναι το default format εξόδου. Αυτό μειώνει τον αριθμό των tokens που χρειάζεται ένα agent για να διαβάσει την απάντηση, αφαιρώντας την ανάγκη για εξωτερικά εργαλεία όπως το jq. Τα pretty‑printed JSON παραμένουν ευανάγνωστα για ανθρώπους, ενώ το condensed format εξοικονομεί context για τα agents.

Η νέα μορφή ρυθμίσεων, το cloudflare.config.ts, γράφεται σε TypeScript. Αυτό προσφέρει type‑checking σε χρόνο μεταγλώττισης, ενσωματωμένη LSP υποστήριξη και τη δυνατότητα να ορίζουμε περιβάλλοντα προγραμματιστικά. Με τη βοήθεια του helper bindings, τα agents μπορούν να αυτοσυμπληρώσουν μεταβλητές όπως environment variables, KV namespaces, D1 databases, R2 buckets, queues και AI services, με το editor να παρέχει τεκμηρίωση inline.

Το defineConfig， mode (development, preview, production) dinamically.switch between different sets of bindings, μειώνοντας την ανάγκη για αντιγραφή‑επικόλληση blocks όπως στο παλαιό Wrangler.

Αγენტ‑κεντρικές δυνατότητες: αναζήτηση εντολών, Vite dev server και εναλλακτική διαχείριση workloads

Με 3.000 διαθέσιμες διαδρομές στο CLI, η cf εισάγει την εντολή cf cli search. Με αυτή, τα agents μπορούν να ρωτήσουν σε φυσική γλώσσα τι χρειάζονται να κάνουν και να λάβουν μια λίστα προτεινόμενων εντολών, βασισμένη στις περιγραφές και τα parameters του API. Η εντολή anuncείται αυτόματα όταν το agent τρέχει --help για πρώτη φορά.

Η cf κάνει default το Vite ως dev server, προσφέροντας Hot Module Replacement (HMR), Rolldown‑based tree‑shaking και ένα πλούσιο ecosystem plugins. Το Cloudflare Vite Plugin, σε συνδυασμό με το Vitest plugin, παρέχει ένα cohesive development‑and‑testing environment που ταιριάζει με το Workers runtime και δίνει ευθεία πρόσβαση στα bindings και τις platform APIs.

Για workloads που εξακολουθούν να χρειάζονται το παλαιό esbuild‑based pipeline (π.χ. Rust ή Python Workers), η cf delegete το build και το deploy στο Wrangler, διατηρώντας backward compatibility ενώ ενθαρρύνει την μετάβαση στο νέο stack.

Τέλος, η cf προσφέρει τις εντολές cf init και cf deploy για γρήγορο bootstrapping νέων project, ενώ η cf migrate μετατρέπει υπάρχοντα Wrangler projects στο νέο format cloudflare.config.ts.