toolbox

My personal toolbox of utility scripts

Browse the toolbox

toolbox.py is a cross-platform CLI and terminal UI for browsing, downloading, verifying, and running utility scripts from the toolbox. The toolbox is a searchable collection of scripts that I use for various tasks, and it is backed by a remote manifest that lists the available scripts and their SHA-256 hashes for verification.

Requirements

• Python 3.9 or newer
• rich

Features

• Browse and search the toolbox website or the command line interface.
• Interactive terminal UI for browsing available scripts.
• Search scripts by name, ID, description, language, category, or tags.
• View script descriptions, usage examples, download URLs, and checksums.
• Download one or multiple scripts directly from the command line.
• Verify every downloaded script against its SHA-256 checksum.
• Run verified Python and shell scripts directly from the TUI.
• Check for newer Toolbox releases with toolbox --version.
• Works on macOS, Linux, and Windows with python3 installed.

Install

Homebrew (macOS)

On macOS, install with Homebrew:

brew tap PiSaucer/homebrew-tap
brew install PiSaucer/tap/toolbox

Python Package (pipx)

Recommended when installing Toolbox as an isolated Python CLI:

pipx install pisaucer-toolbox
toolbox --version

Python Package (pip)

python3 -m pip install pisaucer-toolbox

Python Package (uv)

uv tool install pisaucer-toolbox
toolbox --version

macOS / Linux installer

curl -fsSL https://pisaucer.github.io/toolbox/install.sh | sh

Build from source

Build a wheel:

python3 -m build
pipx install ./dist/pisaucer_toolbox-*.whl
toolbox --version

pipx install .

./install.sh

Toolfile

Toolbox projects can use a human-maintained Toolfile to declare the scripts they need.

# Download utilities
dcurl>=1.0.0
compress-json==1.3.0 # Keep this version reproducible

Install the declared environment, or manage entries directly:

toolbox install
toolbox install dcurl # Alias for `toolbox add dcurl`
toolbox add dcurl
toolbox add dcurl==1.1.0
toolbox add "dcurl>=1.1.0"
toolbox remove dcurl
toolbox update
toolbox update dcurl

Adding a script without an explicit constraint writes a >= constraint using the version currently published in the manifest. For example, toolbox add dcurl may write dcurl>=1.0.0.

toolbox install --file path/to/Toolfile selects a Toolfile outside the current directory. With a script argument, install is an alias for add. Toolfile.lock is generated by Toolbox and records the exact resolved script versions, Git commits, SHA-256 hashes, download sources, and detected system-tool state. Commit both files when you want a reproducible project environment. install reproduces a compatible lock; update intentionally refreshes versions allowed by the Toolfile.

Uninstall

If you used the macOS/Linux installer, run:

./uninstall.sh

Use the matching package manager if toolbox was installed as a package:

brew uninstall toolbox
pipx uninstall pisaucer-toolbox
uv tool uninstall pisaucer-toolbox
python3 -m pip uninstall pisaucer-toolbox

Links

• Toolbox Website
• GitHub Repository
• Releases
• Issues
• PyPI

License

Distributed under the MIT License. See LICENSE for more information.