Aztec Ferris

Gerzain's Workstation Bootstrapper

Embedded Systems Engineer & Embassy Contributor • @leftger

🚀 Install & Bootstrap

Automated, idempotent workstation provisioning for bare-metal C & async Rust development across Linux (Debian/Ubuntu), macOS, and WSL.

curl --proto '=https' --tlsv1.2 -sSf https://leftger.github.io/bootstrap.sh | sh

🦀 Rust & Embedded

  • Rustup: Stable toolchain + rust-src, llvm-tools, clippy, rustfmt, rust-analyzer
  • Targets: Cortex-M (M0+, M3, M4F, M33), RISC-V, Wasm
  • Flashing & Debug: probe-rs, espflash / cargo-espflash
  • Ecosystem: cargo-binstall, cargo-binutils (size, objcopy, objdump), cargo-deny, cargo-llvm-cov, cargo-generate

🔌 Hardware & Toolchains

  • GNU Toolchain: gcc-arm-none-eabi, gdb-multiarch, newlib, openocd
  • Serial & Debug: tio serial monitor, probe-rs udev rules (CMSIS-DAP, ST-Link, J-Link)
  • macOS Polish: Headless Xcode CLI tools installer, Touch ID for sudo (/etc/pam.d/sudo_local)
  • WSL USB: Passthrough helpers for usbipd-win (usb-list, usb-attach, usb-detach)

⚡ Terminal & Shell

  • Zsh + Oh-My-Zsh: Default shell with autosuggestions, syntax highlighting, and zsh-completions
  • Plugins: git, sudo, rust, extract, z, colored-man-pages, command-not-found
  • Modern CLI: btop, mosh, tmux, ripgrep, fd, bat, fzf (fzf --zsh keybindings)
  • GPG Terminal: GPG_TTY pinentry attachment for commit signing

💻 Modern Editors

  • Zed: High-performance code editor (~/.local/bin/zed)
  • Vim: Curated Badwolf, Molokai & Monokai themes, whitespace cleanup, 4-space indent
  • Tmux: TrueColor, vi-mode keys, 10k scrollback, GitHub Dark status bar

🔐 Security & Dotfiles

  • Keys: Automated ED25519 SSH & GPG commit signing key generation
  • Git Defaults: ~/.gitmessage template, global hooks dispatcher (~/.githooks), push.autoSetupRemote, autoStash, alias.pa
  • Credentials: Native macOS osxkeychain and Windows Git Credential Manager for WSL
  • Standards: .editorconfig, .hushlogin (silent login MOTD)

🛠️ Maintenance & Productivity

  • full-upgrade (up): One-stop updater for APT, Homebrew, Rust, Zed, Flatpak, Snap, pipx, npm, and WSL
  • Aliases: mcd, cdr (with dynamic TAB completion), refreshenv, gho browser opener
  • Localization: Automatic host timezone detection + system-wide en_US.UTF-8