updates

README.md

@@ -0,0 +1,54 @@
+# macOS Configuration
+
+Personal macOS setup and configuration files.
+
+## Setup
+
+### 1. Install Homebrew
+
+```bash
+/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+```
+
+### 2. Install packages and apps
+
+```bash
+brew bundle --file=brewfile
+```
+
+### 3. Symlink configuration files
+
+```bash
+ln -sf $(pwd)/fish-config.fish ~/.config/fish/config.fish
+ln -sf $(pwd)/starship.toml ~/.config/starship.toml
+ln -sf $(pwd)/ssh-config ~/.ssh/config
+```
+
+### 4. Set Fish as default shell
+
+```bash
+echo /opt/homebrew/bin/fish | sudo tee -a /etc/shells
+chsh -s /opt/homebrew/bin/fish
+```
+
+### 5. Configure iTerm2
+
+Import `iterm-profile.json` via iTerm2 preferences. Uses 1Password SSH agent for key management.
+
+## Scripts
+
+### clone-resoftware-repos.fish
+
+Clones all repositories from the `resoftware` GitHub organization, organized by customer number:
+
+```bash
+fish clone-resoftware-repos.fish
+```
+
+Repos are cloned via SSH into `~/Repositories/{customer-number}/{repo-name}` based on each repo's `customer-number` custom property. Safe to re-run -- already cloned repos are skipped.
+
+## Updating the Brewfile
+
+```bash
+brew bundle dump --file=brewfile --force
+```