README.md

omaforge - macOS

Automated macOS system setup.

Quick Start

cd ~/Dev/.configs/unix/macos
./macos-setup

Configuration

Edit config.json:

{
  "system": { "hostname": "pixmac" },
  "git": {
    "user_name": "Your Name",
    "user_email": "your@email.com"
  },
  "rust": {
    "tools": ["bat", "eza", "ripgrep", "zoxide", "starship"]
  }
}

Package Management

Interactive

./bin/omaforge-pkg-manage

Add, remove, search packages with availability checking.

Manual

echo "fastfetch" >> packages/brew.packages
./macos-setup

Package Lists

• brew.packages - CLI tools
• cask.packages - GUI applications

What's Installed

• Homebrew setup
• Packages (Homebrew, Cask, Rust)
• System configuration (hostname)
• Git/SSH, NextDNS, dotfiles, ZSH

Reset/Re-run Components

If you need to reset or re-run specific parts:

./bin/omaforge-reset

Interactive menu to reset:

• ZSH configuration
• Dotfiles (stow)
• Fonts
• Git & SSH
• NextDNS
• Rust tools

Post-Install

1. Add SSH key to GitHub:

   cat ~/.ssh/id_ed25519.pub

2. Reload shell:

   exec zsh

Troubleshooting

Homebrew issues

brew update
brew doctor

Package install fails

brew search package-name
brew install package-name

Notes

• All scripts are idempotent (safe to re-run)
• Uses shared scripts from unix/common/
• See main README for overview