A Visual Studio Code extension that provides inline diagnostics for GitHub Actions workflow files. It runs actionlint against your workflow files and surfaces errors directly in the editor as you work.

Requirements

• actionlint must be installed and available on your PATH (or configured via actionlint.executable).
• shellcheck (optional) — enables deeper lint checks for shell scripts in run: steps.
• pyflakes (optional) — enables lint checks for Python scripts in run: steps.

Getting Started

Install from the VS Code Marketplace, Open VSX, or via the CLI:

code --install-extension jimeh.actionlint

The extension activates automatically when a workspace contains a .github/workflows/ directory or when you open a GitHub Actions workflow file.

Features

• Lint on type with configurable debounce (default) or on save.
• Regex-based error ignore patterns (actionlint.ignoreErrors).
• Per-rule diagnostic severity overrides (actionlint.ruleSeverities).
• Configurable actionlint executable path.
• Optional shellcheck and pyflakes integration for deeper run: step analysis, with errors resolved to exact positions within script bodies.
• Initialize Config command to scaffold an .actionlint.yml in the workspace.
• Status bar indicator showing lint state.
• Output channel logging with configurable verbosity.

Configuration

All settings live under the actionlint.* namespace.

Setting	Type	Default	Description
actionlint.enable	boolean	true	Enable or disable actionlint linting.
actionlint.executable	string	"actionlint"	Path to the actionlint binary.
actionlint.runTrigger	"onSave" | "onType"	"onType"	When to run actionlint: on file save or on typing (with debounce).
actionlint.debounceDelay	number	300	Debounce delay in ms for onType trigger mode (50–5000).
actionlint.ignoreErrors	string[]	[]	Regex patterns to ignore matching errors (maps to -ignore flags).
actionlint.shellcheckExecutable	string	""	Path to shellcheck binary. Empty = auto-detect.
actionlint.pyflakesExecutable	string	""	Path to pyflakes binary. Empty = auto-detect.
actionlint.additionalArgs	string[]	[]	Additional arguments to pass to actionlint.
actionlint.logLevel	"off" | "info" | "debug"	"off"	Output channel logging verbosity.
actionlint.ruleSeverities	object	{}	Override diagnostic severity for specific rule kinds. Keys are rule kind strings (e.g. syntax-check, credentials), values are error, warning, information, or hint.

Note: Settings marked as restricted (executable, shellcheckExecutable, pyflakesExecutable, additionalArgs) are ignored in untrusted workspaces.

License

MIT