On Clean Mac OS X

My Mac OS X setup manual.

• 1. Touch ID for sudo authentication (modern approach)
• 2. Homebrew permissions (modern approach)
• 3. Install Homebrew
• 4. clone dotfiles
• 5. Kick setup.sh(Homebrew required)
• 6. Install Vim plugins
• 7. Install Nodebrew
• Extra. Any Manual Tasks

1. Touch ID for sudo authentication (modern approach)

Enable Touch ID for sudo commands instead of password-less sudo (more secure approach).

For macOS Sonoma 14.x and above (recommended):

sudo nano /etc/pam.d/sudo_local
# Add this line:
auth sufficient pam_tid.so

For older macOS versions:

sudo nano /etc/pam.d/sudo
# Add 'auth sufficient pam_tid.so' as the second line

See: Touch ID for sudo on macOS (2025 Guide)

2. Homebrew permissions (modern approach)

Modern Homebrew handles permissions automatically during installation.

For Apple Silicon Macs (M1/M2/M3): Homebrew installs to /opt/homebrew
For Intel Macs: Homebrew installs to /usr/local

No manual ownership changes are required - Homebrew installer sets up proper permissions automatically.

If you encounter permission issues, use:

brew doctor
# Follow the specific suggestions provided

See: Official Homebrew Installation Guide | Homebrew Permissions Troubleshooting

3. Install Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

4. clone dotfiles

cd ~
[email protected]:ryota-murakami/dotfiles.git

5. Kick setup.sh(Homebrew required)

cd dotfiles
./setup.sh

what's doing in setup.sh

• generate dotfile symboliclinks at home directory.
• install all homebrew packages in Brewfile.
• setting fish-shell as a login shell.
  • re-open terminal to activation.
• initialize git submodule.
  • in order to neobundle.vim.

7. Install Vim plugins

open .vimrc, execute folllowing.

:NeoBundleInstall

defined installed pulugins at .vimrc. git

call neobundle#begin(expand('~/.vim/bundle'))
    NeoBundle 'editorconfig/editorconfig-vim'
    ~
call neobundle#end()

8. Install Nodebrew

nodebrew is not provided by homebrew, therefore you have to setup along to the README. https://github.com/hokaccha/nodebrew

Extra. Any Manual Tasks

• install karabiner-elements
• system prefefences > hidden dock
• System Preferences > Keybord > App Shortcut > Others > type action "Log Out ryota..." > set cmd + option + q as shortcut
  • OSX default shortcut cmd + option + q of "Log Out ryota..." is conflict my custom editor's "close project" shortcut
  • See: https://apple.stackexchange.com/questions/210517/disable-shift-cmd-q-for-logout
• Set Unicode Hex Input as a input soruce to remove all option key combination
• Remove cmd + shift + r shortcut from Be Focus Pro