install-tools.sh installs the general-purpose tools that every Webmozarts Claude Code
session uses: just, glab, yq, the sbx CLI, the AWS CLI, Ansible, a Postgres client, Node
and more. The versions are pinned at the top of the script.
Two places run it, so both get the same tools at the same versions:
- the baseline image of docker-sandbox, on Debian;
- the setup script of the Claude Code cloud environments, on Ubuntu.
The script runs as root. It runs more than once on the same machine: the cloud runs it at every session start. So it skips each tool that is already in place, and a second run downloads nothing.
Both download the script from the public GitHub mirror of this repository,
webmozarts/devtools, at main:
-
The docker-sandbox image build resolves the commit of
mainand downloads the script at that commit:git ls-remote https://github.com/webmozarts/devtools.git refs/heads/main
-
The cloud setup script downloads it from
maindirectly:curl --proto '=https' --tlsv1.2 -fsSL --retry 3 \ https://raw.githubusercontent.com/webmozarts/devtools/refs/heads/main/install-tools.sh \ -o /tmp/install-tools.sh bash /tmp/install-tools.sh
Always write refs/heads/main, not a bare main. A bare main resolves to a tag named
main first, if someone ever creates one.
The setup itself is documented in docker-sandbox (kits/baseline/README.md, "Cloud
environments").
The cloud image ships one Node build per major version under /opt/node<major>, and puts
an older one on PATH. In the cloud, install-tools.sh installs no Node. Instead, it links
/opt/node to /opt/node<NODE_MAJOR>, the major the script pins. It does that on every
run and fixes a link that points somewhere else.
docker-sandbox's cloud-session-env.sh relies on this link: it puts /opt/node/bin
first on PATH when it exists. Keep the link when you change the script.
main is what every new image and every new cloud environment installs. So a change on
main goes live for everyone. main is protected: open a merge request, and get it
reviewed before it is merged.
CI runs test-install-tools.sh on Ubuntu 24.04. You can run it yourself as root in a
throwaway container, never on your machine:
docker run --rm --volume "$PWD:/src:ro" ubuntu:24.04 /src/test-install-tools.sh