OS Manuals

/usr/bin/actionlint

Static checker for GitHub Actions workflow files

From actionlint 1.7.12-r12 (os), captured 2026-11-05 by running actionlint --help (exit 0). permalink

Usage: actionlint [FLAGS] [FILES...] [-]

  actionlint is a linter for GitHub Actions workflow files.

  To check all YAML files in current repository, just run actionlint without
  arguments. It automatically finds the nearest '.github/workflows' directory:

    $ actionlint

  To check specific files, pass the file paths as arguments:

    $ actionlint file1.yaml file2.yaml

  To check content which is not saved in file yet (e.g. output from some
  command), pass - argument. It reads stdin and checks it as workflow file:

    $ actionlint -

  To serialize errors into JSON, use -format option. It allows to format error
  messages flexibly with Go template syntax.

    $ actionlint -format '{{json .}}'

Documents:

  - List of checks: https://github.com/rhysd/actionlint/tree/main/docs/checks.md
  - Usage:          https://github.com/rhysd/actionlint/tree/main/docs/usage.md
  - Configuration:  https://github.com/rhysd/actionlint/tree/main/docs/config.md

Flags:
  -color
    	Always enable colorful output. This is useful to force colorful outputs
  -config-file string
    	File path to config file
  -debug
    	Enable debug output (for development)
  -format string
    	Custom template to format error messages in Go template syntax. See the usage documentation for more details
  -ignore value
    	Regular expression matching to error messages you want to ignore. This flag is repeatable
  -init-config
    	Generate default config file at .github/actionlint.yaml in current project
  -no-color
    	Disable colorful output
  -oneline
    	Use one line per one error. Useful for reading error messages from programs
  -pyflakes string
    	Command name or file path of "pyflakes" external command. If empty, pyflakes integration will be disabled (default "pyflakes")
  -shellcheck string
    	Command name or file path of "shellcheck" external command. If empty, shellcheck integration will be disabled (default "shellcheck")
  -stdin-filename string
    	File name when reading input from stdin (default "<stdin>")
  -verbose
    	Enable verbose output
  -version
    	Show version and how this binary was installed
Options (13)
OptionDescriptionSource
-colorAlways enable colorful output.help
-config-file stringFile path to config filehelp
-debugEnable debug output (for development)help
-format stringCustom template to format error messages in Go template syntax.help
-ignore valueRegular expression matching to error messages you want to ignore.help
-init-configGenerate default config file at .github/actionlint.yaml in current projecthelp
-no-colorDisable colorful outputhelp
-onelineUse one line per one error.help
-pyflakes stringCommand name or file path of "pyflakes" external command.help
-shellcheck stringCommand name or file path of "shellcheck" external command.help
-stdin-filename stringFile name when reading input from stdin (default "<stdin>")help
-verboseEnable verbose outputhelp
-versionShow version and how this binary was installedhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.