Cloudflare meluncurkan open beta alat baris perintah (CLI) baru bernama cf, yang dirancang khusus untuk era pengembangan berbasis agen otonom (agentic development). Tersedia melalui npm dengan perintah instalasi global, alat ini diposisikan sebagai pengganti jangka panjang untuk Wrangler—CLI andalan Cloudflare yang selama bertahun-tahun dipakai developer untuk membangun dan mengelola Workers serta layanan terkait.
Langkah ini bukan sekadar pergantian nama atau pembaruan kosmetik. Cloudflare merombak fondasi arsitektur CLI dari bawah ke atas, beralih dari perkakas yang semula dioptimalkan untuk pandangan mata manusia di layar terminal menuju sistem yang dapat dinavigasi, dieksekusi, dan diprogram secara efisien oleh model kecerdasan buatan seperti Claude Code, Codex, dan agen coding otonom lainnya.
Batasan Wrangler dan 280 Jalur Perintah Manual
Wrangler pertama kali dibangun ketika ekosistem serverless Cloudflare masih berskala kecil. Seiring pertumbuhan platform, tiap tim produk di internal Cloudflare menambahkan perintah masing-masing secara independen. Pendekatan ini menghasilkan inkonsistensi sintaksis dan terminologi antarlayanan. Perintah untuk memeriksa status atau mendeskripsikan konfigurasi memiliki pola berbeda di tiap modul: developer menggunakan d1 info untuk database relasional, hyperdrive get untuk akselerator koneksi, atau workflows describe untuk alur kerja terdistribusi.
Secara keseluruhan, Wrangler mencakup sekitar 280 fungsi perintah. Namun, angka ini hanya mewakili sebagian kecil dari kapabilitas platform Cloudflare yang sebenarnya. Sebagian besar perintah Wrangler juga dirancang dengan asumsi pengguna manusia: hasil eksekusi ditampilkan dalam bentuk tabel Unicode di layar monitor.
Bagi agen AI, tabel visual tersebut menimbulkan inefisiensi besar. Agen terpaksa menambahkan parameter --json di setiap baris perintah dan mem-pipe hasilnya ke utilitas seperti jq agar dapat mengekstrak data yang relevan. Tidak semua perintah Wrangler mendukung luaran JSON terstruktur. Format tabel yang memakan ruang juga menguras kuota token pada jendela konteks (context window) LLM, memperlambat latensi penalaran, serta meningkatkan potensi kegagalan parsing data.
Menggunakan Forge untuk Membuka 3.000 Operasi API
Untuk mengatasi keterbatasan tersebut, Cloudflare memanfaatkan pipeline pembuatan API terpadu internal bernama Forge. Alih-alih menulis kode CLI secara manual untuk tiap produk baru, Forge menghasilkan perintah CLI secara otomatis langsung dari skema OpenAPI yang selama ini menjadi sumber dokumentasi resmi dan SDK Cloudflare.
Melalui pendekatan berbasis skema ini, cf langsung memperluas jangkauan perintah dari 280 fungsi warisan Wrangler menjadi lebih dari 3.000 operasi API. Artinya, seluruh permukaan API Cloudflare kini dapat diakses langsung dari satu alat baris perintah.
Dengan satu CLI terpadu, agen AI dapat diinstruksikan untuk menyelesaikan alur kerja infrastruktur yang kompleks dari awal hingga akhir: membuat dan men-deploy Worker, mengonfigurasi penyimpanan terdistribusi D1 atau R2, memasang proteksi Zero Trust melalui Cloudflare Access, membeli domain, hingga mengatur aturan firewall di Cloudflare WAF tanpa harus berpindah ke antarmuka web atau perkakas terpisah.
Output JSON Ringkas dan Pencarian Perintah Semantik
Desain cf menempatkan agen sebagai pengguna utama baris perintah masa depan. Karena itu, cf menjadikan JSON ringkas sebagai format luaran baku (default), bukan tabel teks. Data diformat padat tanpa spasi kosong berlebih untuk meminimalkan konsumsi token agen, tetapi tetap dapat diformat ulang jika dibaca oleh manusia.
Tantangan berikutnya dari CLI dengan 3.000 operasi adalah pembengkakan konteks: agen AI tidak mungkin membaca daftar seluruh perintah ke dalam prompt kerjanya. Untuk menyelesaikan masalah ini, Cloudflare memperkenalkan perintah pencarian semantik bawaan: cf cli search.
Perintah ini memungkinkan agen AI mengajukan pertanyaan dalam bahasa alami mengenai apa yang ingin diselesaikan. Mesin indeks pencarian ringkas di dalam CLI akan mencocokkan maksud tersebut dengan deskripsi OpenAPI dan parameter terkait, lalu mengembalikan daftar perintah yang relevan. Saat agen menjalankan perintah --help untuk pertama kali, sistem secara otomatis mengarahkan agen ke mekanisme pencarian semantik ini.
Konfigurasi TypeScript dan Migrasi dari Wrangler
Perubahan mendasar lain terletak pada berkas konfigurasi. Cloudflare meninggalkan format statis wrangler.toml dan wrangler.jsonc, beralih ke berkas konfigurasi berbasis TypeScript bernama cloudflare.config.ts. Berkas ini memanfaatkan fungsi defineConfig bersama modul bantuan bindings dan triggers.
Pilihan TypeScript memberikan pemeriksaan tipe ketat (type safety) dan integrasi langsung dengan Language Server Protocol (LSP) pada editor kode serta lingkungan agen coding. Agen AI dapat membaca skema konfigurasi secara kontekstual, menerima autokompleksi, dan mengedit dependensi—seperti variabel lingkungan, namespace KV, antrean Queue, atau model Workers AI—tanpa menebak struktur berkas.
Mesin pengembangan lokal juga beralih ke Vite dan bundler berbasis Rust Rolldown secara default, menggantikan esbuild kustom yang sebelumnya terikat pada Miniflare di dalam Wrangler. Developer dapat menguji aplikasi dengan dukungan hot module replacement (HMR) dan ekosistem plugin Vite yang luas.
Untuk memfasilitasi masa transisi, Cloudflare menyediakan perintah otomatis cf migrate untuk mengonversi proyek berbasis Wrangler ke format cloudflare.config.ts. Proyek yang masih membutuhkan alur esbuild, Rust, atau Python Workers tetap didelegasikan ke Wrangler di latar belakang. Cloudflare menegaskan bahwa setelah masa open beta berakhir, versi mayor terakhir Wrangler akan dirilis untuk mengarahkan pengguna ke cf, disertai dukungan pemeliharaan selama 18 bulan.
Sumber https://blog.cloudflare.com/cloudflare-cf-cli-launch Sumber tambahan: https://developers.cloudflare.com/workers/ Konteks: https://github.com/cloudflare/workers-sdk