Gary's Automated Dev Setup Script

Features

This automated setup script manages:

• Core: Homebrew (macOS) / System Packages (Linux), Dotfiles (Zsh/Vim/Tmux), Editor configuration
• Languages: Ruby, Python, Node.js
• Dev Tools: Docker, iTerm2 (macOS)
• Security: 1Password (CLI, GUI, SSH Agent), YubiKey PAM (macOS)
• AI Agents: Claude CLI, Gemini CLI

Installation

Usage

To set up your environment:

bin/setup

Note

If Homebrew is not already installed on macOS, the script will prompt for sudo access to install it. See brew.sh for details.

Contributing

Install bats-core and configure git hooks to ensure tests pass and trailing whitespace is blocked.

Semantic Commits

This project follows Conventional Commits. This allows us to automate versioning and changelogs. Please use the following prefixes for your commits:

• fix:: A bug fix (triggers a Patch release).
• feat:: A new feature (triggers a Minor release).
• feat!: or fix!:: A breaking change (triggers a Major release).
• chore:, docs:, style:, refactor:, test:: Changes that do not affect the production code (do not trigger a release).

Release Procedures

We use Release Please for automated releases.

1. Push your changes to main using Semantic Commits.
2. release-please will automatically create or update a Release PR.
3. This PR includes an updated CHANGELOG.md and bumps the VERSION file.
4. When you are ready to release, simply merge the Release PR.
5. GitHub Actions will then automatically create a GitHub Release and tag the code.