Extensión independiente, no afiliada ni respaldada por GitHub.
Extensión de VS Code para trabajar con workflows de GitHub Actions que se lanzan a mano. Mientras editas el YAML te muestra cómo se verá el formulario "Run workflow" y qué jobs y steps se ejecutarán con los valores que elijas. También puede lanzar el workflow en GitHub.
Funciones
Distribución
Con el panel ancho, el formulario queda fijo a la izquierda y a la derecha hay pestañas: Qué se ejecutará, Inputs y validación y Comandos. Con el panel estrecho (junto al YAML), todo pasa a una columna con secciones plegables. Arriba, unos chips resumen cuántos jobs se ejecutan, cuántos dependen de valores y cuántos se omiten, y cuántos problemas hay.
- Réplica del popover "Run workflow" de GitHub en tema claro y oscuro. Incluye "Use workflow from" con tus ramas y tags, y cada input con su control: texto, número, checkbox, desplegable para
choice y desplegable para environment.
- Se actualiza al escribir y sigue al workflow activo en el editor.
- Pestaña workflow_call para workflows reutilizables. Muestra sus inputs y secrets, y genera el job que lo llama (
uses: / with: / secrets:) listo para copiar.
Qué se ejecutará (simulación)
- Evalúa los
if: de cada job y step con los inputs, la rama elegida y el resultado de los needs, incluido el success() implícito. Cada job y step queda marcado como Se ejecuta, Se omite o Depende de valores en ejecución.
- Explica en una frase por qué algo se omite ("
github.ref es 'refs/heads/main', se esperaba 'refs/heads/desa'") y ofrece un botón Probar con desa.
- Se puede ver como Lista (un carril por job) o como Grafo de
needs.
- ¿Y si…?: una tarjeta por cada valor que solo se conoce al ejecutar, con su origen, a qué afecta y sugerencias tomadas de las propias condiciones (por ejemplo, los teams que busca un
contains()). Cada ? del árbol también se puede fijar ahí mismo.
- Valores que solo se conocen al ejecutar: puedes fijar a mano outputs de steps,
vars, github.actor, etc. Si un script hace echo "is_bot=true" >> $GITHUB_OUTPUT, esos valores literales aparecen como opciones; si solo hay uno, se infiere.
Ejemplo con imageBase.yml: en la rama main, job_ci_buildAndPublishImageBase sale como omitido. Si eliges desa, is_bot = false y el team CT-DSO-COEDevSecOps, se ejecuta. Si además cambias a java17, se omite el step "Export kubectl".
Validación y arreglos rápidos
Los avisos aparecen en el panel Problems y muchos se arreglan con Ctrl+.:
- tipo no soportado → cambiar el tipo
choice sin options → añadir opciones
default fuera de options → añadirlo a options o usar la primera opción
inputs.x usado pero no definido → crear el input
- input sin
description → añadirla
if: que mezcla ${{ }} con texto (GitHub lo evalúa siempre como verdadero) → convertirlo en una sola expresión
Además avisa de:
secrets usado en un if:
needs que apunta a un job inexistente
- id de input inválido
- más de 25 inputs
- inputs sin usar
Ayudas de edición
- Autocompletado de
inputs., needs.<job>.outputs. y steps.<id>.outputs., este último con los valores que escribe el script.
- Información al pasar el ratón e Ir a la definición (F12) para inputs, jobs y steps.
Conexión con GitHub (opcional)
Usa la sesión de GitHub de VS Code; nunca pide un token a mano. Funciona con github.com y con GitHub Enterprise.
- Environments, ramas, tags y variables reales del repositorio.
- Avisa si el workflow no está en la rama por defecto (en ese caso GitHub no muestra el botón), si no existe en la ref elegida o si tu archivo local difiere del que está en GitHub.
- Ejecutar en GitHub…: lanza el workflow (pide confirmación antes) y enlaza a la ejecución.
Otros
- Presets: guarda combinaciones de valores por workflow.
- Vista Formularios de workflows en el Explorador.
- Comando
gh workflow run …, contexto ${{ inputs }} y payload de la API REST, con botón de copiar.
- Interfaz en inglés y español. La réplica de GitHub se mantiene en inglés, como en GitHub.
Uso
Abre un .github/workflows/*.yml y usa cualquiera de estas opciones:
- el botón de previsualización de la barra del editor;
- el CodeLens Previsualizar formulario Run workflow;
- el atajo
Ctrl+K Shift+V;
- la vista Formularios de workflows.
Configuración
| Ajuste |
Por defecto |
Descripción |
ghFormPreview.theme |
auto |
auto / light / dark |
ghFormPreview.language |
auto |
auto (idioma de VS Code) / en / es |
ghFormPreview.maxInputs |
25 |
Límite de inputs de workflow_dispatch |
ghFormPreview.defaultBranch |
main |
Rama que se muestra si no se puede leer la de git |
ghFormPreview.codeLens |
true |
Mostrar el CodeLens |
ghFormPreview.diagnostics |
true |
Publicar avisos en Problems |
ghFormPreview.github.autoConnect |
true |
Usar la sesión de GitHub existente sin preguntar |
Desarrollo
npm install
npm run build # dist/extension.js + dist/webview.js (esbuild)
npm run watch
npm run typecheck # tsc
npm run test:unit # parser, evaluador, simulación, quick fixes, i18n
npm run test:integration # VS Code real (@vscode/test-electron)
npm run package # .vsix
Publicar (en local, sin GitHub Actions)
npm run test:unit && npm run test:integration
npx vsce package # genera el .vsix
gh release create v0.2.0 gh-actions-form-preview-0.2.0.vsix --notes-file CHANGELOG.md
npx vsce login lucqa-it && npx vsce publish # VS Code Marketplace
npx ovsx publish gh-actions-form-preview-0.2.0.vsix -p <token> # Open VSX (opcional)
Pulsa F5 para depurar: se abre samples/ con workflows de ejemplo.
src/
extension.ts activación, comandos, CodeLens
preview.ts panel webview, GitHub, presets
parser.ts YAML → modelo (inputs, workflow_call, jobs, steps) + diagnósticos
expressions.ts evaluador de expresiones ${{ }} con valores desconocidos
simulate.ts qué jobs/steps se ejecutan
fixes.ts quick fixes como ediciones de texto
language.ts autocompletado, hover, definición, diagnósticos, code actions
github.ts API REST con la sesión de VS Code
git.ts ramas/tags/remoto vía la extensión git
workflowsView.ts vista del Explorador
i18n.ts, l10n/ traducciones
webview/ UI del panel
Limitaciones
- La simulación supone que todo lo que se ejecuta termina bien. No expande
matrix ni evalúa hashFiles().
- Sin conexión a GitHub, los environments salen del propio YAML.
- La réplica visual de GitHub es aproximada.