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.
Bash you can trust
shellcheck-clean, shfmt-formatted, and 500+ bats tests on Debian, Arch, Fedora, Alpine, macOS and Windows for every change.
CI →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¶
- Setting up a new machine — bare OS to a working shell, what lands on disk, and how to check it worked
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.