Cloudflare 전반을 위한 CLI 만들기

Cloudflare는 100개 이상 제품과 약 3,000개 HTTP API 작업을 하나의 CLI로 묶는 작업을 진행 중이다.

기존 Wrangler는 Cloudflare 전체를 충분히 커버하지 못했지만, 새 technical preview인 cf는 이를 확장하기 위한 첫 단계다. 지금은 일부 제품만 지원하지만, 앞으로는 Cloudflare API 전반을 다루는 CLI로 발전시키려 한다.

핵심은 새 TypeScript schema다.

• OpenAPI만으로는 CLI 명령, 로컬 개발, Workers bindings, Agent Skills, 문서까지 모두 표현하기 어렵다.
• 그래서 API와 명령, 인자, 컨텍스트를 한 번에 정의할 수 있는 TypeScript 기반 스키마를 만들었다.
• 이 스키마로 CLI, config, bindings, OpenAPI schema 등을 함께 생성한다.

Cloudflare는 특히 에이전트 친화성을 강조한다.

• 명령 체계는 일관성을 강하게 강제한다.
• get과 info처럼 중복되는 표현을 줄이고, --force, --json 같은 옵션도 표준화한다.
• 로컬 리소스와 원격 리소스가 섞이는 상황에서도 출력이 명확해야 에이전트가 혼동하지 않는다.

같이 공개된 Local Explorer는 로컬 개발 경험을 크게 바꾼다.

• Wrangler와 Cloudflare Vite plugin에서 사용할 수 있는 open beta다.
• KV, R2, D1, Durable Objects, Workflows 같은 시뮬레이션 리소스를 로컬에서 직접 탐색할 수 있다.
• 예전에는 .wrangler/state를 직접 뒤지거나 외부 도구를 써야 했지만, 이제는 로컬 UI에서 바인딩과 저장 데이터를 확인할 수 있다.
• 로컬 API는 /cdn-cgi/explorer/api에서 제공되며, OpenAPI spec을 통해 에이전트가 로컬 리소스를 조작할 수 있다.

Cloudflare의 목표는 원격과 로컬의 API 형태를 맞춰서, --local 같은 플래그를 붙여도 같은 명령이 자연스럽게 동작하게 만드는 것이다. 현재는 그 기반을 깔았고, 앞으로 Wrangler와 새 CLI를 더 강하게 통합할 계획이다.