Scriptorium

A collection of useful shell scripts and utilities targeting Bash 4+.

Scripts

Script	Description	Dependencies	Coverage
cz	Conventional commit message builder	gum (interactive mode)
dotenv	Load environment variables from .env files	None
jwt	Decode and verify JSON Web Tokens	openssl, xxd (ECDSA only)
theme	Extensible theme orchestrator for shell environments	None

Installation

Via Nix

# Install individual script
nix profile install github:proventuslabs/scriptorium#dotenv

# Install all scripts
nix profile install github:proventuslabs/scriptorium

# Run without installing
nix run github:proventuslabs/scriptorium#dotenv -- --help

From source

# Clone and build
git clone https://github.com/proventuslabs/scriptorium.git
cd scriptorium
nix develop  # or install dependencies manually
make build

# Add to PATH
export PATH="$PWD/bin:$PATH"

# Or install to ~/.local/bin
cp bin/* ~/.local/bin/

Shell plugin

Source the plugin in your shell config for completions:

# Bash (~/.bashrc)
source /path/to/scriptorium/scriptorium.plugin.sh

# Zsh (~/.zshrc)
source /path/to/scriptorium/scriptorium.plugin.zsh

Contributing

See CONTRIBUTING.md for development setup, build system, and how to add new scripts.

License

See LICENSE file.