La CLI usa el mismo motor visual que la app. Renderiza archivos, entradas canalizadas, diffs de Git, terminales e imágenes locales; puede copiar, guardar, abrir el editor o producir conjuntos completos para documentación y CI.
resultados visibles · Pulsa ⌘K para buscar
Homebrew instala la app y añade vitrine al PATH. Con el DMG, actívala desde Ajustes ▸ General ▸ Herramienta de línea de comandos.
brew install --cask johnny4young/tap/vitrine
vitrine --versionEn zsh, carga el helper solo para esta sesión y captura un mensaje de ejemplo. No necesitas proyecto, cuenta ni licencia PRO. Pega la imagen del portapapeles en Notas u otra app que admita imágenes.
eval "$(vitrine shell-init zsh)"
vgrab --no-context printf 'Hello from Vitrine\n'Las descargas anteriores a v1.3.0 exigen PRO para render, incluido --edit. El envío gratuito con render --edit llegó en v1.3.0. En una versión anterior puedes abrir el editor desde la barra de menús y pegar código gratis. Comprueba la versión instalada y sus notas de versión.
Si ya activaste PRO en la app de descarga directa, este ejemplo autocontenido escribe un PNG. Elige otro destino si app-card.png ya existe.
printf 'print("Hello from Vitrine")\n' | vitrine render --stdin --stdin-name example.swift --out app-card.png --no-overwriteElige el verbo por el resultado que quieres obtener; no necesitas memorizar opciones para empezar.
terminal-captureRuta gratuita de vgrabEl comando local y limitado que usa vgrab. Acepta ancho y contexto de terminal, pero no estilos generales, salida a archivo, archivos auxiliares ni automatización por lotes.
vitrine terminal-capture <capture-file> (--copy [--conceal-clipboard] [--filename <text>] [--title <text>] | --edit) [--terminal-width <n>]renderCrear una imagenRenderiza un archivo, la entrada estándar, un diff de Git o una imagen local. Guárdalo, cópialo o envía la fuente al editor.
vitrine render <input> --out <image> [options]multi-sizeUna fuente, varios destinosCarga una fuente una sola vez y exporta tamaños deterministas como OpenGraph, X, LinkedIn y Story en una carpeta.
vitrine multi-size <input> --out <folder> [--presets <ids>]batchRenderizar una carpeta con seguridadConvierte un árbol de fuentes en imágenes con recorrido recursivo, filtros, simulación, manifiestos y resultados estrictos para CI.
vitrine batch <input-folder> --out <output-folder> [options]recipeInspeccionar recetas portátilesValida o muestra una receta nombrada explícitamente sin renderizar. Vitrine nunca busca configuración en el repositorio ni en carpetas superiores.
vitrine recipe <validate|show> <path> [--json]listDescubrir identificadores válidosLista temas, lenguajes, ajustes, fuentes, fondos, marcos, formatos, perfiles y otros valores incluidos en la compilación instalada.
vitrine list <catalog> [--json]versionVerificar la compilación instaladaMuestra la versión y el número de compilación antes de iniciar AppKit. Es una comprobación rápida y segura para automatizaciones.
vitrine --version [--json]shell-initInstalar ayudantes de terminalMuestra las funciones de shell de vgrab y vpane. Nada se ejecuta en segundo plano; solo actúan cuando las invocas.
vitrine shell-init [zsh|bash|fish]Ejemplos completos para tareas reales. Puedes copiarlos y cambiar solo las rutas.
El lenguaje se infiere del nombre del archivo y el formato de la extensión.
vitrine render Sources/App.swift --out app-card.pngUsa una pista de nombre para que la detección y los metadatos sigan siendo útiles.
cat Component.tsx | vitrine render --stdin \
--stdin-name Component.tsx --copyLee Git directamente, conserva prefijos estables y limita la imagen a las rutas que estás explicando.
vitrine render --git-diff main...HEAD \
--git-path Vitrine/CLI --git-context 6 \
--out cli-review.pngÚtil antes de confirmar cambios: la imagen coincide con el índice y no con trabajo no relacionado.
vitrine render --git-staged --out staged-review.pngvgrab conserva el color y añade el proyecto, la rama Git cuando existe y el comando exacto sobre el resultado.
vgrab npm test
vgrab -e git status
vgrab --no-context dateLa captura básica con vgrab es gratis. Usa --no-context cuando los argumentos, rutas o nombres de rama deban mantenerse privados.
Una imagen local puede usar el mismo lienzo, fondo, sombra y marcos de navegador o dispositivo que la app.
vitrine render --image dashboard.png --out showcase.png \
--frame browser --frame-appearance dark \
--window-title app.example.com --background nightInspecciona primero la receta y luego nómbrala al renderizar. Las opciones explícitas siguen teniendo prioridad.
vitrine recipe validate docs.vitrine-recipe.json
vitrine recipe show docs.vitrine-recipe.json
vitrine render README.md --out readme.png \
--recipe docs.vitrine-recipe.json --scale 2Las filas detectadas se ocultan en la imagen y se sustituyen en cada archivo de texto auxiliar.
vitrine render config.swift --out safe.png \
--redact-secrets --sidecars allUn --blur-box visual no limpia el texto fuente. Usa --redact-lines o --redact-secrets cuando haya contenido sensible.
Una fuente se renderiza en cada tamaño con nombres de archivo estables.
vitrine multi-size launch.swift --out launch-assets \
--presets twitter,linkedin,opengraph \
--recipe launch.vitrine-recipe.jsonSimula primero, exige entradas, falla si omite archivos y conserva evidencia legible por máquinas.
vitrine batch Sources --out docs/cards --recursive \
--include-ext swift,md --dry-run --fail-on-empty
vitrine batch Sources --out docs/cards --recursive \
--include-ext swift,md --fail-on-empty --fail-on-skipped \
--manifest docs/cards/manifest.json \
--skipped-report docs/cards/skipped.jsonEnvía la fuente al editor cuando la automatización te acerca al resultado pero la imagen final necesita anotaciones.
vitrine render --git-diff main...HEAD --editLa referencia sigue la ayuda del binario. Usa la búsqueda para encontrar cualquier opción en segundos.
Elige una fuente y, si hace falta, limítala o asígnale un nombre.
--stdinLee texto desde la entrada estándar, hasta 5 MB.
--stdin-name<name>Infiere lenguaje y metadatos desde un nombre sin leer ese archivo.
--image<path>Embellece una imagen local en lugar de renderizar texto.
--git-diff<range>Carga una revisión o rango local con /usr/bin/git, sin shell ni descarga de red.
--git-stagedCarga solo los cambios preparados en el repositorio actual.
--git-path<path>Limita una fuente Git a una ruta literal; repítelo para varias rutas.
--git-context<0...100>Define líneas sin cambios alrededor de cada bloque; el valor predeterminado es 3.
-e, --editAbre la fuente en Vitrine en vez de escribir o copiar una imagen. Se rechazan las opciones exclusivas del renderizado (--out, --copy, archivos complementarios, --theme, --preset, --scale, --format, --profile, --no-overwrite).
Elige el destino y cómo las automatizaciones comprueban el resultado.
-o, --out<path>Ruta de imagen o carpeta para multi-size y batch.
--copyCopia la imagen al portapapeles de macOS. Con --out, primero se escribe el archivo; una salida rasterizada se copia tal cual y una salida PDF copia una versión PNG. Sin --out, solo se acepta PNG.
--conceal-clipboardCon --copy, pide a los gestores compatibles que traten la exportación como confidencial. Otras apps aún pueden leerla; no elimina contenido ni vacía el portapapeles.
--format<png|pdf|heic|avif>Selecciona la codificación. Una extensión conocida la elige automáticamente; AVIF requiere un codificador ImageIO del sistema (Tahoe o posterior).
--profile<srgb|p3>Selecciona el perfil de color de las imágenes PNG, HEIC, AVIF y del portapapeles; sRGB es el predeterminado.
--scale<1|2|3>Multiplica las dimensiones lógicas para obtener los píxeles finales.
--preset<id>Usa un tamaño de destino de vitrine list presets.
--canvas-size<WxH>Define un lienzo lógico exacto de 64–2048 puntos.
-q, --quietOculta la salida de éxito y conserva los errores.
--jsonEmite resultados estructurados para render, multi-size, batch, list, recipe o version.
--no-overwrite, --no-clobberEvita reemplazar imágenes, archivos auxiliares, manifiestos o informes de omitidos existentes.
-h, --helpMuestra la ayuda local de la compilación instalada.
Empieza con valores predeterminados, una receta o un ajuste integrado; las opciones explícitas se aplican al final.
--theme<id>Tema de sintaxis de vitrine list themes.
--language<id>Fuerza un lenguaje en vez de inferirlo.
--style-preset<id>Aplica un ajuste visual integrado e inmutable.
--recipe<path>Carga una receta portátil de espacio de trabajo nombrada explícitamente.
--font<family>Familia tipográfica de vitrine list fonts.
--font-ligatures, --no-font-ligaturesActiva o desactiva ligaduras de programación.
--font-size<10...20>Tamaño de la fuente en puntos.
--padding<16...64>Relleno del lienzo en puntos.
--corner-radius<0...48>Radio de las esquinas de la tarjeta.
--shadow-radius<0...40>Radio de desenfoque de la sombra.
--terminal-width<1...1000>Fija el ancho de reconstrucción; vgrab -w lo define automáticamente.
--wrap-columns<40...200>Ajusta líneas largas en una columna estable.
--format-code, --tidyAplica el ajuste local de indentación antes de renderizar.
--line-numbers, --no-line-numbersMuestra u oculta los números de línea.
--chrome, --no-chromeMuestra u oculta el marco de ventana.
--shadow, --no-shadowMuestra u oculta la sombra renderizada.
Usa una fuente de fondo; los modificadores de imagen requieren --background-image.
--transparentRenderiza un fondo con transparencia real.
--background<id>Degradado integrado de vitrine list backgrounds.
--background-color<hex>Color sólido RGB o RGBA.
--background-gradient<hex,hex,...>Degradado personalizado con al menos dos colores.
--background-angle<0...360>Dirección de un degradado personalizado; valor predeterminado 135.
--background-image<path>Usa una imagen local como fondo del lienzo.
--background-fit<fill|fit>Recorta para llenar o conserva la imagen completa.
--background-blur<0...40>Desenfoca localmente una imagen de fondo.
--background-dimming<0...1>Aplica una capa oscura normalizada sobre la imagen.
Estos controles se aplican cuando --image es la entrada.
--frame<id>Usa none, macos-window, browser, macbook o iphone.
--frame-appearance<auto|light|dark>Controla la apariencia de un marco seleccionado.
Añade contexto para que la imagen se entienda fuera del repositorio.
--window-title<text>Título en el marco de ventana o navegador.
--filename<text>Etiqueta de archivo en la cabecera.
--title<text>Título principal de metadatos.
--alt-text<text>Texto alternativo para los archivos complementarios Markdown/HTML, hasta 1024 caracteres. Requiere --markdown-sidecar o --html-sidecar; no se dibuja en la imagen y no se admite con --edit.
--caption<text>Texto de apoyo bajo el título.
--language-badge, --no-language-badgeMuestra u oculta la etiqueta del lenguaje.
Las coordenadas de 0 a 1 permiten que las marcas escalen con el lienzo.
--callout<text>Añade una llamada de texto.
--callout-x, --callout-y<0...1>Define el ancla; proporciona ambas coordenadas.
--callout-color<hex>Color del texto de la llamada.
--callout-size<2...28>Peso visual de la llamada.
--counter<1...99>Añade una insignia numerada.
--counter-x, --counter-y<0...1>Define el centro; proporciona ambas coordenadas.
--counter-color<hex>Color de relleno del contador.
--counter-size<2...28>Peso visual del contador.
--arrow<x1,y1,x2,y2>Dibuja una flecha repetible desde la cola a la punta.
--arrow-color, --arrow-size<hex> / <2...28>Color y peso compartidos por todas las flechas.
--line<x1,y1,x2,y2>Dibuja una línea recta repetible.
--line-color, --line-size<hex> / <2...28>Color y peso compartidos por todas las líneas.
--rectangle<x1,y1,x2,y2>Contornea una región repetible.
--rectangle-color, --rectangle-size<hex> / <2...28>Color y peso compartidos por todos los rectángulos.
--highlighter<x1,y1,x2,y2>Resalta una región repetible.
--highlighter-color<hex>Color compartido del resaltador.
--blur-box<x1,y1,x2,y2>Desenfoca visualmente una región; no limpia los archivos auxiliares.
--highlight-lines<spec>Resalta filas desde 1, como 3,7-9,12.
--redact-lines<spec>Oculta filas en la imagen y las sustituye en los archivos auxiliares.
--redact-secretsBusca secretos probables y oculta las filas correspondientes.
--focus-lines, --no-focus-linesAtenúa o restaura las filas fuera del resaltado.
--diff-bands, --no-diff-bandsMuestra u oculta bandas de cambios al estilo GitHub.
Añade texto, un logo local o ambos con la misma capa de Brand Kit.
--watermark<text>Texto de la marca de agua.
--watermark-logo<path>Imagen de logo local.
--watermark-color<hex>Color del texto; requiere texto.
--watermark-position<corner|free>Usa una esquina nombrada o posición libre.
--watermark-x, --watermark-y<0...1>Centro normalizado para posición libre; proporciona ambas.
Usa destinos estables y haz visible cualquier resultado parcial en CI.
--presets<ids|all>Destinos de multi-size separados por comas; all es el valor predeterminado.
--recursiveRecorre subcarpetas y conserva rutas relativas.
--dry-runDescubre y carga entradas sin escribir artefactos.
--include-ext<list>Considera solo las extensiones indicadas.
--exclude-ext<list>Ignora extensiones antes de cargar archivos.
--fail-on-emptyFalla cuando ningún archivo se renderizaría.
--fail-on-skippedFalla al terminar si alguna entrada fue omitida.
--skipped-report<json>Escribe un informe de archivos omitidos.
--manifest<json>Escribe rutas y dimensiones de resultados reales o planeados.
Entrega texto seleccionable junto a la imagen sin cambiar sus píxeles.
--text-sidecarEscribe un archivo .txt de texto plano.
--markdown-sidecarEscribe una referencia Markdown y la fuente en un bloque.
--html-sidecarEscribe un fragmento HTML con la imagen y la fuente escapada.
--sidecars<text,markdown,html|all>Activa varios archivos auxiliares con una opción.
Las diferencias entre Homebrew, DMG, App Store y compilaciones de desarrollo explican la mayoría de problemas de instalación.
Con Homebrew, ejecuta brew reinstall --cask johnny4young/tap/vitrine. Con el DMG, abre Ajustes ▸ General ▸ Herramienta de línea de comandos ▸ Instalar…, o usa Copiar comando para obtener el enlace manual con sudo ln -s.
vgrab básico es gratis. Antes de v1.3.0, render exige PRO incluso con --edit; usa Abrir editor y pega el ejemplo para trabajar gratis. Para generar imágenes con render, multi-size, batch o vpane, activa la licencia en la app de descarga directa y vuelve a ejecutar el comando. Las compilaciones Release ignoran VITRINE_PRO_UNLOCK por diseño.
Es intencional: ese canal no distribuye herramientas en PATH. Instala el DMG firmado o el paquete de Homebrew para usar la CLI.
Pasa --language <id> o, cuando uses --stdin, añade --stdin-name con una extensión útil. Consulta vitrine list languages.
Omite --no-overwrite para reemplazarlo, cambia --out o elimina el artefacto anterior. En batch, las imágenes existentes se informan como omitidas; un manifiesto o informe de omitidos existente hace fallar la ejecución.
--blur-box solo cambia los píxeles. Usa --redact-lines o --redact-secrets para limpiar también los archivos auxiliares.
Muchos programas desactivan el color fuera de un TTY. Usa vgrab, o fuerza el color en el programa antes de enviarlo a vitrine render --stdin.
Cambia --out o --copy por --edit. Vitrine abre la fuente en el editor para ajustar y anotar manualmente.
El renderizado de código, terminales e imágenes locales no necesita red, Screen Recording ni Accessibility. Una receta solo se carga cuando pasas --recipe; Git se invoca directamente sin shell, pagers, textconv ni descargas implícitas.
No encontramos esa opción. Prueba con render, Git, recipe, redact o batch.