Skip to content
| Marketplace
Sign in
Visual Studio Code>Linters>GitHub Actions Form PreviewNew to Visual Studio Code? Get it now.
GitHub Actions Form Preview

GitHub Actions Form Preview

lucqa-it

|
1 install
| (1) | Free
Live preview of the GitHub Actions "Run workflow" form (workflow_dispatch / workflow_call), simulation of which jobs run, validation, quick fixes and real runs.
Installation
Launch VS Code Quick Open (Ctrl+P), paste the following command, and press enter.
Copied to clipboard
More Info

GitHub Actions Form Preview

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.

Previsualización del formulario

  • 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.
  • Contact us
  • Jobs
  • Privacy
  • Manage cookies
  • Terms of use
  • Trademarks
  • Your Privacy Choices
  • Consumer Health Privacy
© 2026 Microsoft