bpkg

Package manager for bash scripts.

TLDR

Install a package globally

$ bpkg install [package-name] -g

Install a specific version

$ bpkg install [package-name]@[version]

Install package locally (in ./deps/)

$ bpkg install [package-name]

Install dependencies from bpkg.json

$ bpkg getdeps

Run a package script

$ bpkg run [script-name]

Run a script with arguments

$ bpkg run [script-name] "[arg1]" "[arg2]"

List available scripts

$ bpkg run --list

Get package info

$ bpkg package

SYNOPSIS

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.

PARAMETERS

-g, --global

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

-l, --list

List available commands (with run)

-h, --help

Show help message

-V, --version

Show version information

@version

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

SUBCOMMANDS

install

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

getdeps

Install dependencies defined in bpkg.json

run

Execute a script defined in the package

package

Display package metadata

update

Update installed packages

source

Source a package's bash files

term

Terminal utilities

CAVEATS

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.

HISTORY

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.