KNEL/TSYSDevStack
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
452841e3204015f35ed6d88e8863728fe9f070d0
TSYSDevStack/ToolboxStack/README.md

1.8 KiB
Raw Blame History

🧰 ToolboxStack

ToolboxStack provides reproducible developer workspaces for TSYSDevStack contributors. The current toolbox-base image captures the daily-driver container environment used across the project.

Contents

Area Description Path
Dev Container Image Ubuntu 24.04 base with shell tooling, mise, aqua-managed CLIs, and Docker socket access. output/toolbox-base/Dockerfile
Build Helpers Wrapper scripts for building (build.sh) and running (run.sh) the Compose service. output/toolbox-base/
Devcontainer Config VS Code Remote Container definition referencing the Compose service. output/toolbox-base/.devcontainer/devcontainer.json
Prompt & Docs Onboarding prompt plus a feature-rich README for future collaborators. output/toolbox-base/PROMPT, output/toolbox-base/README.md
Collaboration Notes Shared design prompts and coordination notes for toolbox evolution. collab/

Quick Start

cd output/toolbox-base
./build.sh        # build the image with UID/GID matching your host
./run.sh up       # launch the toolbox-base service in the background
docker exec -it tsysdevstack-toolboxstack-toolbox-base zsh

Use ./run.sh down to stop the container when you are finished.

Contribution Tips

  • Document every tooling change in both the PROMPT and README.md.
  • Prefer installing CLIs via aqua and language runtimes via mise to keep the environment reproducible.
  • Keep cache directories (.build-cache/, mise mounts) out of Git—they are already covered by the repo’s .gitignore.