Skip to content

just-bashit

just-bashit

One curl. Any machine. Your shell.

Turns a bare Linux, macOS or WSL box into a dev box, taking only the parts you choose.

. <(curl -sSL https://just-buildit.github.io/get-jb.sh)   # jbx, in this shell
jbx setup-system --dry-run                                # the plan, no changes

Any box → your box

Packages, compiler, shell config, git, uv, PowerShell and Claude Code. One ssh key per machine, reused across every WSL distro and checked against GitHub. It ends by listing exactly what is installed, and applies the changes to the shell you ran it from.

setup-system →

Run it, don't install it

jbx fetches a script by name or URL, calls one function and discards it. Cached, hash-pinnable, and nothing left on PATH.

jbx →

Bash you can trust

shellcheck-clean, shfmt-formatted, and 500+ bats tests on Debian, Arch, Fedora, Alpine, macOS and Windows for every change.

CI →

CI Coverage shellcheck shfmt bats pre-commit GitHub release

Coverage Report · Test Report

Quick Start

Get jbx on any Linux, macOS or WSL box (only bash and curl needed), then read the plan before anything changes:

. <(curl -sSL https://just-buildit.github.io/get-jb.sh)   # jbx, in this shell
jbx setup-system --dry-run                                # the plan, no changes

Then take the lot, or just the parts you want:

jbx setup-system                   # everything below
jbx setup-system -s shell,ssh,git  # only these
jbx setup-system -x claude,pwsh    # all but these
Step What you get
deps compiler, make, cmake, git, curl, ssh, gpg, age
shell bash config, a source line in ~/.bashrc and ~/.profile
ssh permissions fixed; a user key named for this machine, only if you have none
git defaults only where you haven't set one
tools uv, plus pre-commit hooks in a repo that has them
pwsh PowerShell 7 + PSScriptAnalyzer
claude Claude Code

certs and sshd run only when you name them; on native Windows sshd and folders run by default. Every step in full · Setting up a new machine

To use the libraries in your own scripts, unpack a release and source what you need. They depend on each other, so keep the package whole:

tar xf just-bashit.tar.gz
. just-bashit/src/just_bashit/datetime.sh
iso-8601-basic
# 20260522T143200Z

CLI Tools

Tool Purpose
bootstrap.toml The manifest — system packages and fetched tools
just-runit Ephemeral runner — fetch a script, call a function, discard
install-deps Install packages declared in a bootstrap.toml
setup-system Take a fresh machine to a working one — packages, shell, ssh, git
inspect Snapshot installed package versions into a .versions file

Guides

Libraries

Library Functions
datetime iso-8601-basic
environment set-bashrc unset-bashrc check-command-exists
file add-line remove-line add-contents
format trim-from color-echo
logging log log-wait
make-run mk-var mk-vars mk-run mk-has mk-origin
match is-number
network test-internet-access
path get-scriptpath set-scriptpath
pkg get-pkg-mgr get-pkg-version
toml toml_get toml_discover_groups toml_discover_tools

Platform Support

Tested on every release across six platforms:

Platform Package manager
Debian (latest) apt
Arch Linux (latest) pacman
Fedora (latest) dnf
Alpine Linux (latest) apk
macOS (latest) brew
Windows (MSYS2 bash) winget

Templates

See Templates for copy-paste starting points: a full-featured function template with getopts, a minimalist variant, an executable script template with strict mode and exit traps, and the opinionated bash configuration setup-system installs.