Canvora × Codex
CLI de visuales de marca para Codex
Codex entrega tu código; Canvora entrega los assets del lanzamiento. Gráficos de release, imágenes OG, cabeceras de blog y posts sociales, generados desde los propios archivos de tu repositorio.
Créditos gratis, sin tarjeta. Mantén siempre a una persona en el bucle.
Ponlo en marcha
# Instala las skills de Canvora
npx skills add canvora/canvora-mcp
# Configura tu clave de API
export CANVORA_API_KEY=vd_...
# Usa Codex para generar los assets del lanzamiento
codex "genera una imagen OG y un gráfico de lanzamiento para esta
release, a partir de CHANGELOG.md, con nuestro kit de marca"Esto es lo que entrega tu agente
Una generación, localizada dos veces. El mismo diseño, recompuesto de forma nativa en español y en árabe: escritura de derecha a izquierda bien resuelta, no un inglés en espejo.
Generado con los mismos comandos que ves en esta página.
Cómo funciona
1. De los archivos del repositorio al input
El changelog es la fuente de contenido
codex "resume CHANGELOG.md para un post de lanzamiento"
# Codex ejecuta entonces:
ID=$(canvora generate --input "v2.4: builds en paralelo, \
bundles un 40% más pequeños, nueva API de plugins" \
--format og_image,blog_header,linkedin_post \
--brand "$BRAND_ID" | head -1)2. Consulta desde el sandbox
Asíncrono por diseño: Codex sigue trabajando mientras tanto
canvora status "$ID" --json
# { "status": "processing", ... } -> reintenta
# { "status": "completed", "outputs": [ ... ] }3. Los archivos, al repositorio
Los assets aterrizan donde el flujo de release los espera
canvora download "$ID" --dir ./assets/launch/
git add assets/launch/ && git commit -m "v2.4 launch assets"¿Qué es Codex?
Codex es el agente de programación autónomo de OpenAI. Se ejecuta en tu terminal y en tu IDE, lanza comandos de shell en un entorno aislado (sandbox) y completa tareas de varios pasos, incluida la producción de los assets de lanzamiento que acompañan a tu código.
Nativo en CLI e IDE
Codex ejecuta la CLI de Canvora directamente en su sandbox. Sin navegador ni herramienta de diseño: los visuales están a un comando de shell del repositorio.
Descubrimiento vía SKILL.md
Codex lee los archivos SKILL.md instalados y aprende por su cuenta los comandos de Canvora, sus flags y el patrón de consulta asíncrona.
Sesiones en paralelo
Genera los visuales de la release en una terminal mientras otra sesión redacta las notas de la versión y una tercera sigue refactorizando.
Una sesión real de Codex
Los assets de la release como parte de la propia tarea de release
$ codex "Prepara la release v2.4: notas, tag y
visuales de lanzamiento para el blog y redes"
Codex: Manos a la obra.
1. Notas de la versión redactadas desde CHANGELOG.md
2. Leyendo SKILL.md -> comandos de canvora encontrados
3. canvora generate --input "..." \
--format og_image,blog_header,linkedin_post
4. Consultando: canvora status 0d9aac1e --json -> completed
5. canvora download --dir assets/launch/
6. Commit hecho: notas de la versión + 3 visuales de marca
Listo para etiquetar y publicar.Terminales en paralelo
Los visuales se generan mientras tú sigues lanzando
# Terminal 1 - assets de lanzamiento
$ codex "genera el set de visuales de lanzamiento desde CHANGELOG.md"
# Terminal 2 - versiones localizadas para el anuncio en la UE
$ codex "localiza los visuales de lanzamiento al alemán y al francés"
# Terminal 3 - sigue programando
$ codex "arregla el test de reintentos inestable en ci/"Por qué Codex + Canvora
- Funciona en el sandbox de Codex: comandos de shell normales y una sola variable de entorno para autenticarse
- --json en cada comando: salida estructurada que Codex puede parsear y usar
- Errores tipados: un 402 incluye lo necesario frente a lo disponible antes de cobrar nada
- generate asíncrono + status encajan con tareas autónomas de varios pasos
- Imágenes OG, cabeceras de blog y formatos sociales cubren toda la superficie del lanzamiento
Referencia de comandos
Añade --json a cualquier comando para obtener salida legible por máquina. El progreso va a stderr; los resultados, a stdout.
| Comando | Descripción |
|---|---|
| canvora generate | Crea visuales a partir de --idea, texto con --input, --url o --file-url; elige formatos, marca, estilo e idioma |
| canvora status <id> | Consulta una generación; --json devuelve el estado y las URLs de los archivos generados |
| canvora download <id> | Guarda los archivos generados en un directorio |
| canvora localize <id> | El mismo diseño, recompuesto de forma nativa en otro idioma (RTL incluido) |
| canvora variations <id> | Tomas alternativas de una generación terminada |
| canvora edit <outputId> | Revisa un visual con una instrucción en lenguaje natural |
| canvora formats | Lista los más de 100 ids de formato |
| canvora brands | Lista los kits de marca (colores, tipografías, logo, tono) |
| canvora credits | Muestra el saldo de créditos |
Más de 100 formatos, un solo motor
Cada formato tiene composición y zonas seguras adaptadas a su plataforma: tu agente elige por id.
Carrusel de Instagram
Hasta 20 diapositivas, del gancho al CTA
Carrusel de LinkedIn
Posts de documento deslizables
Pitch deck
Sets de diapositivas coherentes
Post y story de Instagram
Formatos de feed y verticales
Tarjeta de datos
Una cifra, diseñada para impactar
Infografía
Visuales de datos y procesos
Cabecera de blog e imagen OG
Toda la superficie de lanzamiento
Creatividades publicitarias
Anuncios display y sociales
Preguntas frecuentes
¿Cómo se autentica Codex? +
Con export CANVORA_API_KEY=vd_... en el entorno donde se ejecuta Codex. Las claves se crean en canvora.ai, en Integrations → API Keys; se guardan como hash, se revocan al instante y registran su uso por clave, así que la clave del agente queda aislada de tu acceso personal.
¿Cuánto cuesta un set de lanzamiento? +
Créditos planos: 10 por visual individual (una imagen OG, una cabecera de blog), 15 por diapositiva de carrusel o deck. La API comprueba el saldo antes de deducir y devuelve el déficit exacto en un 402, de modo que Codex puede informar del coste antes de ejecutar. Las generaciones fallidas se reembolsan automáticamente.
¿Puede usar nuestra marca real? +
Sí: los kits de marca guardan colores, tipografías, logo y tono. canvora brands lista los ids de los kits; pasa --brand <id> (añade --logo para colocar el logo) y cada asset sale con tu marca sin que Codex tenga que describir tu paleta cada vez.
¿Interfiere con el sandbox? +
No. La CLI es un binario de Node normal que habla HTTPS con api.canvora.ai; el progreso va a stderr y los resultados a stdout. No toca nada más: las descargas van solo a donde apunte --dir.
También funciona con
La próxima llamada a herramienta de tu agente es un departamento de diseño.
Crea una cuenta gratis, configura una clave y deja que Codex entregue visuales de marca.