1# macOS Setup
2
3Idempotent macOS configuration. System converges to declared state.
4
5## Usage
6
7```bash
8./run.sh # all modules
9./run.sh brew casks # specific modules
10./run.sh --help # list modules
11```
12
13## Modules
14
151. **homebrew** - Install Homebrew
162. **brew** - Sync formulae (removes unlisted)
173. **casks** - Sync casks (removes unlisted)
184. **defaults** - macOS system defaults
195. **dock** - Dock applications
206. **network** - Computer/host names
217. **firewall** - Firewall settings
228. **shell** - Login shell
239. **ssh** - SSH keys from Proton Pass
24
25## Structure
26
27- `lib.sh` - Shared helpers
28- `modules/` - Self-contained modules (state at top, logic below)