bpkg

bpkg [-hV] command [arguments]

bpkg is a lightweight bash package manager that fetches and installs shell scripts from GitHub repositories. It handles downloading, setting permissions, and organizing scripts either globally or on a per-project basis.Packages are configured using a bpkg.json file that defines metadata, dependencies, and executable scripts. The tool works similarly to npm for Node.js or pip for Python.

-g, --global

Install package globally to ${PREFIX:-/usr/local/bin}

Install development dependencies as well

List available commands (with run)

Show help message

Show version information

Specify package version (e.g., package@1.0.0)

install

Install a package (globally with -g, locally without)

Install dependencies defined in bpkg.json

Execute a script defined in the package

Display package metadata

Update the local bpkg index of available packages

Source a package's bash files into the current shell

Interactively create a bpkg.json file

Parse and query JSON (used internally)

Show package readme or details from the index

List packages available in the local index

Terminal utilities

Packages must have a valid bpkg.json or package.json file. Global installation requires appropriate write permissions to the target directory. Dependencies are installed recursively in deps/ subdirectories.

bpkg was created as a simple package manager specifically for bash scripts, inspired by package managers like npm. It provides a standardized way to share and reuse shell script utilities across projects.

bash(1), npm(1), basher(1)

Source code · Homepage