Canvora × Codex
CLI de visuais on-brand para o Codex
O Codex entrega o seu código — a Canvora entrega os assets de lançamento. Gráficos de release, imagens OG, headers de blog e posts sociais, gerados a partir dos arquivos do seu próprio repositório.
Créditos grátis, sem cartão. Garanta que sempre haja um humano no loop.
Comece agora
# Instale as skills da Canvora
npx skills add canvora/canvora-mcp
# Defina sua API key
export CANVORA_API_KEY=vd_...
# Use o Codex para gerar assets de lançamento
codex "gere uma imagem OG e um gráfico de lançamento para esta
release, a partir do CHANGELOG.md, usando nosso kit de marca"É isso que o seu agente entrega
Uma geração, localizada duas vezes. Mesmo design, recomposto nativamente em espanhol e árabe — escrita da direita para a esquerda do jeito certo, não inglês espelhado.
Gerado com os mesmos comandos mostrados nesta página.
Como funciona
1. Dos arquivos do repositório ao input
O changelog é a fonte de conteúdo
codex "resuma o CHANGELOG.md para um post de lançamento"
# O Codex então roda:
ID=$(canvora generate --input "v2.4: builds paralelos, \
bundles 40% menores, nova API de plugins" \
--format og_image,blog_header,linkedin_post \
--brand "$BRAND_ID" | head -1)2. Consulte no sandbox
Assíncrono por natureza — o Codex continua trabalhando enquanto isso
canvora status "$ID" --json
# { "status": "processing", ... } -> tente de novo
# { "status": "completed", "outputs": [ ... ] }3. Arquivos no repositório
Os assets caem onde o workflow de release espera
canvora download "$ID" --dir ./assets/launch/
git add assets/launch/ && git commit -m "v2.4 launch assets"O que é o Codex?
O Codex é o agente autônomo de programação da OpenAI. Ele roda no seu terminal e IDE, executa comandos de shell em um ambiente com sandbox e conclui tarefas de várias etapas — incluindo produzir os assets de lançamento que saem junto com o seu código.
Nativo em CLI e IDE
O Codex executa a CLI da Canvora direto no sandbox. Sem navegador, sem ferramenta de design — os visuais estão a um comando de shell do repositório.
Descoberta via SKILL.md
O Codex lê os arquivos SKILL.md instalados e aprende sozinho os comandos, flags e o padrão de polling assíncrono da Canvora.
Sessões paralelas
Gere os visuais da release em um terminal enquanto outra sessão escreve as release notes e uma terceira continua refatorando.
Uma sessão real do Codex
Assets de release como parte da tarefa de release
$ codex "Prepare a release v2.4: notes, tag e
visuais de lançamento para o blog e as redes"
Codex: Trabalhando nisso.
1. Rascunhei as release notes a partir do CHANGELOG.md
2. Lendo SKILL.md -> comandos 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 feito: release notes + 3 visuais on-brand
Pronto para criar a tag e publicar.Terminais paralelos
Os visuais são gerados enquanto você continua entregando
# Terminal 1 - assets de lançamento
$ codex "gere o conjunto de visuais de lançamento a partir do CHANGELOG.md"
# Terminal 2 - versões localizadas para o anúncio na UE
$ codex "localize os visuais de lançamento para alemão e francês"
# Terminal 3 - continue programando
$ codex "corrija o teste flaky de retry em ci/"Por que Codex + Canvora
- Roda no sandbox do Codex: comandos de shell simples, uma env var para autenticação
- --json em todos os comandos — saída estruturada que o Codex pode interpretar e usar
- Erros tipados: um 402 inclui necessário vs disponível antes de qualquer cobrança
- Generate assíncrono + status combinam com tarefas autônomas de várias etapas
- Imagens OG, headers de blog e formatos sociais cobrem toda a superfície de lançamento
Referência de comandos
Adicione --json a qualquer comando para saída legível por máquina. O progresso vai para o stderr, os resultados para o stdout.
| Comando | Descrição |
|---|---|
| canvora generate | Crie visuais a partir de --idea, texto com --input, --url ou --file-url; escolha formatos, marca, estilo e idioma |
| canvora status <id> | Consulte uma geração; --json retorna o status e as URLs dos arquivos de saída |
| canvora download <id> | Salve os arquivos de saída em um diretório |
| canvora localize <id> | Mesmo design, recomposto nativamente em outro idioma (RTL incluído) |
| canvora variations <id> | Versões alternativas de uma geração concluída |
| canvora edit <outputId> | Revise um visual com uma instrução em linguagem natural |
| canvora formats | Liste todos os 100+ ids de formato |
| canvora brands | Liste os kits de marca (cores, fontes, logo, tom) |
| canvora credits | Mostre o saldo de créditos |
Mais de 100 formatos, um só motor
Cada formato tem composição e zonas de segurança corretas para a plataforma — seu agente escolhe pelo id.
Carrossel de Instagram
Até 20 slides, do gancho ao CTA
Carrossel de LinkedIn
Posts de documento deslizáveis
Pitch Deck
Conjuntos coesos de vários slides
Post e Story de Instagram
Formatos de feed e vertical
Cartão de Estatística
Um número, desenhado para impactar
Infográfico
Visuais de dados e processos
Header de Blog e Imagem OG
A vitrine do lançamento
Criativos de Anúncio
Anúncios display e sociais
Perguntas frequentes
Como o Codex se autentica? +
export CANVORA_API_KEY=vd_... no ambiente em que o Codex roda. As chaves são criadas em canvora.ai, em Integrations → API Keys, armazenadas como hash, revogáveis na hora e rastreadas por chave — assim a chave do agente fica isolada do seu acesso pessoal.
Quanto custa um conjunto de lançamento? +
Créditos fixos: 10 por visual único (uma imagem OG, um header de blog), 15 por slide de carrossel ou deck. A API verifica o saldo antes de debitar e retorna a diferença exata em um 402, então o Codex pode informar o custo antes de executar. Gerações que falham são reembolsadas automaticamente.
Ele pode usar a nossa marca de verdade? +
Sim — kits de marca guardam cores, fontes, logo e tom. canvora brands lista os ids dos kits; passe --brand <id> (adicione --logo para posicionar o logo) e todo asset sai on-brand sem o Codex precisar descrever sua paleta toda vez.
Isso interfere no sandbox? +
Não. A CLI é um binário Node simples falando HTTPS com api.canvora.ai; o progresso vai para o stderr, os resultados para o stdout. Ela não mexe em mais nada — os downloads vão só para onde --dir apontar.
Também funciona com
A próxima chamada de ferramenta do seu agente é um departamento de design.
Crie uma conta grátis, defina uma chave e deixe o Codex entregar visuais com a sua marca.