Install shfmt using Winget - wingetCollections

shfmt Daniel Martí

Use this command to install shfmt:

winget install --id=mvdan.shfmt -e

Format shell programs

shfmt is a shell formatting tool designed to format, validate, and improve the readability of shell scripts. It supports POSIX Shell, Bash, and mksh syntax, making it versatile for developers working with various shell environments.

Key Features:

Syntax Validation: Ensures scripts adhere to correct syntax while formatting.
Cross-Platform Compatibility: Works seamlessly on Linux, macOS, and Windows.
Integration Support: Can be easily integrated into CI/CD pipelines or editor plugins for automated code styling.

Audience & Benefit:
Ideal for software engineers, DevOps professionals, and anyone writing shell scripts. shfmt helps maintain consistent code style, reduces syntax errors, and enhances readability, ultimately improving development efficiency and code quality. It can be installed via winget for easy setup on Windows systems.

README

sh

A shell parser, formatter, and interpreter. Supports POSIX Shell, Bash, and mksh. Requires Go 1.24 or later.

Quick start

To parse shell scripts, inspect them, and print them out, see the syntax package examples.

For high-level operations like performing shell expansions on strings, see the shell package examples.

shfmt

go install mvdan.cc/sh/v3/cmd/shfmt@latest

shfmt formats shell programs. See canonical.sh for a quick look at its default style. For example:

shfmt -l -w script.sh

For more information, see its manpage, which can be viewed directly as Markdown or rendered with scdoc.

Packages are available on Alpine, Arch, Debian, Docker, Fedora, FreeBSD, Homebrew, MacPorts, NixOS, OpenSUSE, Scoop, Snapcraft, Void and webi.

gosh

go install mvdan.cc/sh/v3/cmd/gosh@latest

Proof of concept shell that uses interp. Note that it's not meant to replace a POSIX shell at the moment, and its options are intentionally minimalistic.

Related Programs

Versions

3.12.0

3.11.0

3.10.0

3.9.0

3.8.0

3.7.0

3.6.0

Website

github.com

License

Last Updated

7/9/2025

cd syntax
go test -run=- -fuzz=ParsePrint

$ echo '${array[spaced string]}' | shfmt
:1:16: not a valid arithmetic operator: string
$ echo '${array[weird!key]}' | shfmt
:1:8: reached ! without matching [ with ]
$ echo '${array[dash-string]}' | shfmt
${array[dash - string]}

$ echo '$((foo); (bar))' | shfmt
1:1: reached ) without matching $(( with ))

docker build -t my:tag -f cmd/shfmt/Dockerfile .

docker run --rm -u "$(id -u):$(id -g)" -v "$PWD:/mnt" -w /mnt my:tag

shfmt Daniel Martí

README

sh

Quick start

shfmt

gosh

Related Programs

Fuzzing

Caveats

JavaScript

Docker

Related projects