Forge, el proceso de código abierto para generar SDK, interfaces de línea de comandos, documentación y mucho más

Ciudad de México, 5 de octubre de 2026.— Cloudflare, Inc. (NYSE: NET), la empresa líder de conectividad en la nube, presentó Forge, un enfoque renovado para generar SDK, interfaces de línea de comandos, documentación y bibliotecas. Forge es un proceso de generación de código abierto, modular y extensible que cualquiera puede desplegar y ejecutar de forma gratuita.

Forge está en sus primeros pasos, pero ya genera el contenido necesario para el CLI cf, y en los próximos meses impulsará la documentación de la API de Cloudflare, los SDK y mucho más.

La empresa desarrolló Forge porque lo necesitaba para tratar a los agentes como sus clientes. Ahora lo publica como código abierto porque considera que todos deberían poder generar todas las superficies que los agentes necesitan. Antes, solo los productos para desarrolladores necesitaban CLI, SDK de API y servidores MCP, todos con una documentación excelente. Ahora esos son los requisitos básicos para cualquier producto.

La API superó a sus generadores

La API de Cloudflare cuenta con más de 3,500 operaciones, y los cientos de servicios que alimentan estas API están escritos en muchos lenguajes, incluidos Rust, Go, TypeScript y Python. Al embarcarse en el desarrollo de una CLI para toda la API de Cloudflare, incluidos los SDK y la documentación de la API, se necesitaba de un proceso de generación de código capaz de manejar esta escala. Ese proceso debe ser lo suficientemente flexible para funcionar en todos los lenguajes y adaptarse a las formas de trabajar de cada uno de los equipos de ingeniería.

Se requería una forma para reducir la sobrecarga de coordinación entre grupos. Cuando un equipo de producto de Cloudflare realiza un cambio en la API, tiene que poder utilizar una versión de vista previa de la CLI, el SDK y el sitio de documentación generados para toda Cloudflare antes de fusionar ese cambio y ofrecerlo a los clientes. Necesitaban una forma de garantizar que no rompieran inadvertidamente el pipeline de generación, y un sistema que pudieran ampliar para generar más que un simple SDK, desde Cap'n Web hasta MCP y más allá.

El equipo probó varios productos alojados que pretendían resolver esto y utilizaron algunos de ellos en producción. Ninguno resolvió este problema y algunos dejaron de funcionar por completo. Se implementaba un cambio que sin querer rompía el proceso de generación, otro equipo lo detectaba en el momento del lanzamiento, y perdió demasiado tiempo nadando contra la corriente a través de herramientas alojadas que no podía controlar, coordinando cambios entre equipos y proveedores.

Así fue como empezaron a desarrollar Forge.

Forge busca solucionar todos estos problemas: se ejecuta en CI, en los repositorios de la API de cada equipo, igual que el revisor de código de la IA y los procesos de pruebas. Analiza cada cambio y luego genera versiones de vista previa de la CLI, la documentación y los SDK con solo los cambios resaltados, que se pueden instalar para probar. Es el mismo principio que Workers Previews: una versión de vista previa completa para cada cambio, pero aplicada a la generación de SDK a escala, incluso cuando la superficie de la API está distribuida en cientos de servicios y repositorios. Eso es lo que Forge busca ofrecer.

Forge te ayuda a detectar problemas en la integración continua, antes de que causen problemas a futuro.

Los transformadores de Forge pueden generar cualquier cosa, incluido Cap'n Web

Cloudflare tiene más razones que la mayoría para querer un generador que pueda superar los objetivos de lenguaje habituales. Cap'n Web es el sistema RPC de Cloudflare que permite a TypeScript llamar a una API remota como si fuera un método local.

Forge hace posible tomar una especificación OpenAPI y generar Cap'n Web directamente. Esto permite generar bindings de Workers a otras API. Al fin y al cabo, los enlaces en el entorno de ejecución de Workers se implementan como Workers que exponen métodos RPC.

Esto no es exclusivo de Cap'n Web: otras herramientas conocidas que quizás ya se utilizan necesitan lo mismo. Si se usa TanStack Query, idealmente de pueden generar enlaces de TanStack Query para una aplicación, creados directamente desde su propia API. Siempre actualizados, siempre validados contra tu API real. Lo mismo ocurre con la generación de esquemas Zod o Valibot, servidores MCP, o cualquier otra cosa que facilite el consumo de una API.

Esto es posible porque los generadores de código de Forge son flexibles. Están diseñados para mover información de una salida a otra.

Los transformadores de Forge se pueden encadenar: generar salidas a partir de otras salidas

Forge fue diseñado para ser modular y extensible y admitir muchos tipos de entradas y salidas. Forge proporciona generadores de CLI, SDK y documentación, pero nada les impide añadir un transformador que genere un paquete específico de una biblioteca o incluso un panel de control o una aplicación completa. Forge admite OpenAPI como tipo de entrada hoy en día, pero lo han diseñado para permitir AsyncAPI, GraphQL, Cap'n Proto, Protobuf u otros formatos de entrada en el futuro.

Esto va más allá de la simple compatibilidad: les permite encadenar objetivos, mediante la salida de un objetivo para producir otros. Esto es habitual en otros generadores donde los objetivos de CLI y Terraform se producen a partir del SDK de Go. Pero lo que falta, y lo que Forge proporciona, es una forma de que el usuario controle este sistema de encadenamiento por sí mismo.

El propio equipo de Cloudflare precisaba una solución para esto, porque su propia CLI cf está escrita en TypeScript, algo que otros generadores de SDK generalmente no encadenan para las CLI. Pero la situación les hizo reconocer un problema mayor: ¿por qué debería una herramienta generadora de SDK tomar esta decisión por ustedes? Quizás son un equipo de Python y quieren que la CLI esté en Python.

Se puede pensar, «Bueno, ¿y a quién le importa si está en Python o no? El código se genera automáticamente», es porque las CLIs son diferentes. Las CLIs suelen introducir comportamientos solo locales que no tendrían sentido en un SDK. Comportamientos que se escriben a mano porque inherentemente no están respaldados por ninguna llamada a la API. Por ejemplo, la CLI cf tiene comandos como cf dev y cf build que se añaden sobre el resto de la salida generada. Estos comandos necesitan llamar a API de TypeScript de otros paquetes como Vite.

Ahora, si estás generando tu CLI y tu documentación puramente a partir de tu especificación OpenAPI, ¿cómo introduces esos comandos escritos a mano en tu documentación, para que puedan documentarse junto al resto?

No se detectó ninguna herramienta existente que haga esto hoy en día, y sin embargo es exactamente lo que se requiere para cf. Así que lo incorporaron a Forge.

Modificar tu API sin afectar a los usuarios

Forge también los está preparando para una mejor versión de API. La API v4 de Cloudflare ha sido la única versión principal de su API durante 10 años. Desde entonces, parece que no han lanzado ninguna nueva versión principal, pero según las definiciones de SemVer han realizado bastantes cambios que merecerían una nueva versión principal. Al mismo tiempo, varias operaciones de su API presentan etiquetas internas «v2» o identificadores «beta» que han sobrevivido con dificultades a esa parte del ciclo de vida del producto.

Después de tantos años con la API v4, el equipo es muy consciente de que una nueva versión v5 dejaría atrás a muchos de sus clientes. Por eso, Forge está lanzando novedades y están trabajando en un enfoque de versionado de API que permita lanzar nuevas versiones principales de API sin afectar a los clientes o SDKs antiguos.

Muy pronto se dará a conocer más información sobre los SDK, incluidos TypeScript, Rust, Python, Go, PHP y Terraform. Especialmente Terraform. Se sabe que actualizar cualquier proveedor de Terraform conlleva su propio nivel de rigor, y van a prestar una atención especial a la transición de Terraform.

Las herramientas esenciales deben estar al alcance de todos

Cloudflare considera que construir herramientas para APIs es una parte fundamental del Internet, y deberían poder hacerlo sin necesitar un producto SaaS. Deberían ser dueños de sus SDKs, CLIs y documentación. Y si los generan, deberían poder hacer con ellos lo que quieran, donde quieran, de forma gratuita.

Por eso pone Forge a disposición de todos como código abierto bajo la permisiva licencia Apache 2.0 con la intención de que la gente se una en este camino y contribuya.