Cloudflare CLI が抱えていた根本的な課題
Cloudflare を日常的に使っているエンジニアなら一度は感じたことがあるはずだ。「この設定、Wrangler でできないのか？」と。実際、Cloudflare には 100以上の製品 と 約3,000のHTTP APIエンドポイント が存在するが、CLIツールである Wrangler がカバーしていたのはそのごく一部に過ぎなかった。多くの製品はダッシュボードか REST API を直接叩くしかなく、自動化やスクリプト化の障壁になっていた。
さらに近年、AIエージェントが Cloudflare API の主要な利用者 になりつつある。開発者がコーディングエージェントを使ってアプリのデプロイ・設定・ログ確認をする時代において、CLIのカバレッジの低さはそのまま「エージェントが使えない機能」を意味する。この課題を解決するために、Cloudflare は Wrangler の次世代版となる新CLI「cf」の開発を開始した。
今すぐ試せる：テクニカルプレビューの使い方
現時点でテクニカルプレビュー版を試すには以下のコマンドを実行するだけだ。
# 一時的に試す場合
npx cf
# グローバルにインストールする場合
npm install -g cfただし現状サポートされているのは Cloudflare 製品のごく一部。今後数ヶ月で既存の Wrangler 機能と統合し、Cloudflare API 全体をカバーする CLI として進化させていく計画だ。「公開しながら最高のフィードバックを得る」という姿勢で早期公開したとのことで、実験的な利用に最適なタイミングと言える。
技術的な革新：TypeScript スキーマによるコード生成パイプライン
最も注目すべきは、その背後にある コード生成アーキテクチャの刷新 だ。Cloudflare はすでに OpenAPI スキーマから SDK・Terraform プロバイダ・MCP サーバーを自動生成していたが、CLI・Workers Bindings・wrangler.jsonc の設定ファイルは依然として手動メンテナンスだった。これはヒューマンエラーが多く、スケールしない仕組みだった。
新しいアプローチでは TypeScript 型定義をスキーマとして採用 し、そこから CLI コマンド・引数・設定ファイル・Agent Skills・ドキュメントまでを一括生成できる仕組みを構築した。OpenAPI が REST API を記述するのに対し、この独自 TypeScript スキーマは「ローカル開発と API リクエストを組み合わせたインタラクティブな CLI コマンド」「RPC ベースの Workers Bindings」なども表現できる。Cloudflare が TypeScript を「ソフトウェアエンジニアリングの共通言語」と捉えているのが伝わってくる選択だ。
エージェント時代の CLI 設計：一貫性とコンテキストエンジニアリング
AI エージェントにとって CLI の 一貫性 は命取りになる。あるコマンドが info で情報取得し、別のコマンドが get を使っていたら、エージェントは存在しないコマンドを呼び出してクラッシュする。大規模な組織でレビューによってこれを防ぐのは「ザル」だ、とCloudflare は率直に認めている。
その解決策として、スキーマ層でルールとガードレールを強制する 仕組みを導入した。例えば：
- 情報取得は常に
get（infoは使わない） - 強制実行フラグは常に
--force（--skip-confirmationsは不可） - JSON 出力は常に
--json
この一貫性は人間にとっても使いやすいが、エージェントにとって特に重要 だ。また、Cloudflare の全 API を1,000トークン以下で利用できる Code Mode MCP サーバーとの連携も視野に入れており、エージェント時代のインフラ操作体験を根本から再設計している。
まとめ：Wrangler の次世代形態として注目すべき理由
「cf」はまだテクニカルプレビューであり、今すぐ本番利用できるものではない。しかし、その設計思想――TypeScript スキーマによる全インターフェース統一生成、エージェントファーストの一貫性設計――は、次世代のインフラ CLI がどうあるべきか を示す重要な先例になる。
Cloudflare Workers や R2、D1 を使っているエンジニア、あるいは AI エージェントを使ったインフラ自動化に取り組んでいる人にとって、この動向は要注目だ。npx cf で今日からフィードバックに参加できるのも嬉しいポイント。元記事では TypeScript スキーマの詳細な設計図も公開されており、コード生成パイプラインの実装に興味がある人は必読だ。