Tooling

The most distinctive parts of this repo are not just the packages or host files. They are the tools built around them.

You do not need to understand every tool here on a first read. For newcomers, this section is most useful after Architecture and Home Manager, when the shared package-set model is already clear.

Key Surfaces

• pog, the CLI wrapper system used throughout mods/pog/*.
• kshell, a fast Kubernetes debug-shell wrapper with enough pod-spec control to be genuinely useful.
• hex, the Nix-driven spec and render workflow used here for Kubernetes-oriented configuration.
• snowball, a targeted way to package up and deploy portable systemd service bundles via mods/snowball.nix.
• foundry, the repo's shared image-building surface for cloud/installer OS images and task-focused container images.
• mica, a lighter package-focused environment manager that complements Home Manager.
• hms and hmx, the repo's preferred rebuild and switch helpers defined in mods/hms.nix.
• scripts.nix outputs, checked shell-script utilities exposed as flake outputs from scripts.nix.

Why This Matters

This repo is opinionated about ergonomics. The point is not only to define packages and systems, but to turn them into a workflow that is actually pleasant to use.

Outside Links

• pog docs: https://pog.gemologic.dev/
• pog repo: https://github.com/jpetrucciani/pog
• hex docs: https://hex.gemologic.dev/
• hex repo: https://github.com/jpetrucciani/hex
• mica repo: https://github.com/gemologic/mica