TSYSDevStack-Toolboxes/artifacts/ToolboxStack/toolbox-base/docs/TOOLS.md

🧰 TSYSDevStack Toolbox Base – Installed Tooling

Category	Tooling	Notes
Shells & Prompts	🐚 zsh • 🐟 fish • 🧑‍💻 bash • ⭐ starship • 💎 oh-my-zsh	Shell choice is flexible; Starship prompt configured for all three; oh-my-zsh with git + fzf plugins.
Runtime & CLI Managers	🪄 mise • 💧 aqua	mise manages language/tool runtimes (activated for zsh/bash/fish); aqua manages standalone CLIs (global config under ~/.config/aquaproj-aqua/aqua.yaml).
Core CLI Utilities	📦 curl • 📥 wget • 🔐 ca-certificates • 🧭 git • 🔧 build-essential + headers • 🔍 ripgrep • 🧭 fzf • 📁 fd • 📖 bat • 🔗 openssh-client • 🧵 tmux • 🖥️ screen • 📊 jq	Provides day-to-day development ergonomics and compile toolchain requirements (openssl/zlib/sqlite/readline/ffi headers, pkg-config).
Aqua-Managed CLIs	🐙 gh • 🫖 tea • 🌀 lazygit	Installed via aqua; extendable by editing ~/.config/aquaproj-aqua/aqua.yaml.
Container Workflow	🐳 Docker integration via host Docker socket	Compose file binds /var/run/docker.sock read-only; docker CLI expected on host.
Misc	🗂️ /workspace mount (rw) • 👤 Non-root user toolbox mapped to host UID/GID	Container runs as the mapped host user; current repo mounted to /workspace.

Usage Highlights

1. Build the image: ./build.sh
2. Start the dev environment: ./run.sh up
3. Attach a shell: docker exec -it tsysdevstack-toolboxstack-toolbox-base zsh (or bash / fish)
4. Manage runtimes: mise use python@3.12 (per project)
5. Install extra CLIs: add entries to ~/.config/aquaproj-aqua/aqua.yaml then run aqua install

ℹ️ Documentation policy: Update this file whenever tooling changes (new utilities, removals, or configuration shifts) so contributors always have an accurate inventory.