# Install beautysh with Homebrew, Nix

Bash beautifier. Version 6.4.3 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:beautysh
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install beautysh
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#beautysh
```

  Evidence: nixpkgs package indexes: beautysh from https://raw.githubusercontent.com/NixOS/nixpkgs/master/pkgs/top-level/all-packages.nix

## Package facts

- **Package key:** brew:beautysh
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/beautysh>
- **Version:** 6.4.3
- **Source summary:** Bash beautifier
- **Homepage:** <https://github.com/lovesegfault/beautysh>
- **Repository:** <https://github.com/lovesegfault/beautysh>
- **Upstream docs:** <https://github.com/lovesegfault/beautysh#readme>
- **License:** MIT
- **Source archive:** <https://files.pythonhosted.org/packages/ae/9d/ed7b7dc146881698f5d71ce8a384f8e8f80790b1b12c73598efa81b8c3ed/beautysh-6.4.3.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- beautysh (cli)
- beautysh (alias)

## Dependencies

- python@3.14

## Install behavior

- Post-install hook: not defined
- Bottle: available on all

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 6.4.3
- Local data: ok
- Upstream repository: https://github.com/lovesegfault/beautysh
- info: No package-manager update timestamp was available.
- info: No cached GitHub release or tag data was available.
## Project history and usage

beautysh is a Bash beautifier and formatter that can rewrite shell scripts from the command line or through its Python API.

### Project history

The README frames beautysh around the difficulty of formatting Bash safely because shell syntax is ambiguous and keywords can also appear as variable names. The project chooses a pragmatic formatter rather than trying to reimplement the Bash interpreter.

The official repository was created in 2016, and the GitHub releases show continued maintenance from early Python-package releases through 2025 and 2026 releases.

### Adoption history

beautysh is distributed through Python packaging and Nix according to its README, and through Homebrew and Nix according to the supplied package metadata.

### How it is used

Users run beautysh over one or more shell files, optionally with flags for indentation, backup behavior, check mode, function style, and variable style. The README warns that it overwrites submitted files, so backups matter.

Configuration is documented through command-line arguments first, then a [tool.beautysh] section in pyproject.toml, then EditorConfig settings in .editorconfig.

### Why package nerds care

beautysh is a small packaging-friendly formatter: one command, local config files, and enough caution around Bash edge cases to be useful in editor, CI, or pre-commit style workflows.

### Timeline

- 2016: The official GitHub repository for beautysh was created.
- 2018: The GitHub releases include a 3.11 release named for relicensing to MIT.
- 2019: The GitHub releases show 5.x releases.
- 2025-2026: The GitHub releases show active 6.x maintenance.

### Related projects

- Bash is the language being formatted. EditorConfig is related because beautysh reads indentation settings from .editorconfig, and PyPI/Nix are documented installation routes.

### Sources

- <https://github.com/lovesegfault/beautysh#readme>
- <https://github.com/lovesegfault/beautysh/releases>
- input.json source_facts.package-manager


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: pyproject.toml, .editorconfig
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** beautysh
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable

## Other Package-Manager Records

- Nix - beautysh: normalized package name match | nixpkgs package indexes: beautysh from https://raw.githubusercontent.com/NixOS/nixpkgs/master/pkgs/top-level/all-packages.nix


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [shfmt](https://www.automicvault.com/pkg/brew/shfmt/) - Shares av.db curated category or tags: bash, cli, developer-tools, formatter, formatters.
- [js-beautify](https://www.automicvault.com/pkg/brew/js-beautify/) - Shares av.db curated category or tags: beautifier, cli, developer-tools, formatter, formatters.
- [buildifier](https://www.automicvault.com/pkg/brew/buildifier/) - Shares av.db curated category or tags: cli, developer-tools, formatter, formatters.
- [cljfmt](https://www.automicvault.com/pkg/brew/cljfmt/) - Shares av.db curated category or tags: cli, developer-tools, formatter, formatters.
- [dfmt](https://www.automicvault.com/pkg/brew/dfmt/) - Shares av.db curated category or tags: cli, developer-tools, formatter, formatters.
- [dockerfmt](https://www.automicvault.com/pkg/brew/dockerfmt/) - Shares av.db curated category or tags: cli, developer-tools, formatter, formatters.
- [fnlfmt](https://www.automicvault.com/pkg/brew/fnlfmt/) - Shares av.db curated category or tags: cli, developer-tools, formatter, formatters.
- [fourmolu](https://www.automicvault.com/pkg/brew/fourmolu/) - Shares av.db curated category or tags: cli, developer-tools, formatter, formatters.
- [fprettify](https://www.automicvault.com/pkg/brew/fprettify/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, developer, developer-tools, formatter, formatters.
- [snakefmt](https://www.automicvault.com/pkg/brew/snakefmt/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, developer, developer-tools, formatter, formatters.

## Combined YAML source

View the package source record on GitHub. [combined/beautysh.yml](https://github.com/automic-vault/db/blob/main/combined/beautysh.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
