arcanelabsio — zsh — shellcraft

shellcraft.

A macOS developer-machine bootstrapper.


Bootstraps and maintains a macOS developer machine with profile-based package selection, preview-first execution, and managed-block dotfile adoption. Rebuild your workstation in an hour without losing any of your customizations.

Or via one-line remote bootstrap:

bash <(curl -fsSL https://raw.githubusercontent.com/arcanelabsio/shellcraft/v1.0.0/setup-my-mac.sh) --plan

Hosted on GitHub. Requires macOS and Homebrew. MIT licensed.

Install

make plan PROFILE=core
make install PROFILE=core
make doctor PROFILE=core

Latest release

First stable release

  • Preview-first executionmake plan PROFILE=… shows what will happen before anything is written. --plan is the default for setup-my-mac.sh.
  • Profile-based package selection — additive profiles (core, backend, ai, frontend) so the same machine can pick up only what it needs: PROFILE=core,backend,ai.
  • Managed-block dotfile adoption~/.zprofile, ~/.zshrc, ~/.gitconfig, ~/.tmux.conf are adopted via named include blocks. Everything outside the block is yours and survives every run.
  • Opt-in identity changes — login-shell change, font install, GUI-assisted Xcode CLT install all default to off.
  • Maintainer toolchain — repo-wide lint enforced at commit time, smoke tests for fresh and existing machines.

Links

  • GitHub — source code and README
  • DESIGN.md — the pattern vs. the implementation