1. Resources
  2. /
  3. Plugins
  4. /
  5. shellcheck-buildkite-plugin

Shellcheck Buildkite Plugin Build status

A Buildkite plugin that runs shellcheck against your shell scripts using the koalaman/shellcheck docker image.

Example

This will check all shellscripts with shellcheck.

steps:
  - plugins:
      - shellcheck#v1.4.0:
          files: scripts/*.sh

Configuration

Required

files (string or array of strings)

The files (or globs) to run shellcheck on.

Optional

extended_glob (boolean)

Enable using extended glob patterns, e.g. *.+(sh|bash)

Default: false

recursive_glob (boolean)

Enable using recursive globbing, e.g. **/*.sh

Note: requires at least Bash 4 on the Buildkite Agent

Default: false

options (string or array of strings)

Command line options to pass to shellcheck.

Default: "--color=always"

version (string)

Version of docker image to use.

Default: latest

image (string)

Which shell check image to use.

Default: koalaman/shellcheck

Developing

To run the tests:

docker-compose run --rm tests bats tests

License

MIT (see LICENSE)

The plugins listed on this webpage are provided for informational purposes only. They have not undergone any formal security review or assessment. While we strive to provide useful resources, we cannot guarantee the safety, reliability, or integrity of these plugins. Users are strongly advised to conduct their own security evaluations before downloading, installing, or using any plugin. By using these plugins, you acknowledge and accept any risks associated with their use. We disclaim any liability for any harm or damages arising from the use of the plugins listed.

Start turning complexity into an advantage

Create an account to get started with a 30-day free trial. No credit card required.

Buildkite Pipelines

Platform

  1. Pipelines
  2. Pipeline templates
  3. Public pipelines
  4. Test Engine
  5. Package Registries
  6. Mobile Delivery Cloud
  7. Pricing

Hosting options

  1. Self-hosted agents
  2. Mac hosted agents
  3. Linux hosted agents

Resources

  1. Docs
  2. Blog
  3. Changelog
  4. Webinars
  5. Plugins
  6. Case studies
  7. Events
  8. Migration Services
  9. Comparisons

Company

  1. About
  2. Careers
  3. Press
  4. Brand assets
  5. Contact

Solutions

  1. Replace Jenkins
  2. Workflows for AI/ML
  3. Testing at scale
  4. Monorepo mojo
  5. Bazel orchestration

Legal

  1. Terms of Service
  2. Acceptable Use Policy
  3. Privacy Policy
  4. Subprocessors
  5. Service Level Agreement

Support

  1. System status
  2. Forum
© Buildkite Pty Ltd 2025