mates-macos-setup

Nastavení macOS workstation + Hermes AI asistent. Kompletní automatizace: Homebrew, macOS defaults, Fish shell, Hermes CLI.

Jsi začátečník? Čti od Začínáme – vše krok za krokem.

---

📦 Co tu je

Soubor	Co dělá
Brewfile	Seznam všech aplikací (Homebrew)
osx-defaults.sh	Nastaví Finder, Dock, klávesnici, Safari
configure-fish.sh	Nastaví Fish shell s aliasy
install-hermes.sh	Nainstaluje Hermes AI agenta
configure-hermes.sh	Nastaví Hermes (API klíč z keychainu)
hermes-config.example.yml	Ukázková konfigurace Hermes

---

🚀 Začínáme (nový Mac)

Krok 1: Nainstaluj Homebrew

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

Krok 2: Naklonuj repo

git clone http://<server-ip>:3000/mates/mates-macos-setup.git
cd mates-macos-setup

Krok 3: Nainstaluj všechny aplikace

brew bundle --file=Brewfile

Tím se nainstaluje všechny aplikace z Brewfile:

• CLI: fish, eza, fd, bat, fzf, btop, jq, yq, ffmpeg, deno, python, exiftool, ...
• GUI: Chrome, Firefox, Discord, WhatsApp, Bitwarden, Notion, Obsidian, VSCode, OBS, VLC, Spotify, ...

Krok 4: macOS defaults

bash osx-defaults.sh

Tím se nastaví:

• Finder: zobrazit skryté soubory, přípony, cestovní panel, icnv (ikony)
• Dock: magnification, skrýt nedávné aplikace, tilesize=33
• Trackpad: pravý klik, momentum scroll
• Terminal: profil Clear Dark

Krok 5: Fish shell

bash configure-fish.sh

Tím se nastaví ~/.config/fish/config.fish s aliasy:

Alias	Co dělá
update	Spustí ~/Skripty/update-macos.sh
dk-update, dk-backup, dk-cleanup, ...	Docker skripty
dk-list	Seznam záloh
dk-nas-mount, dk-nas-status	NAS mount

Krok 6: Hermes (volitelné)

bash install-hermes.sh    # nainstaluje Hermes
bash configure-hermes.sh  # nastaví API klíč z keychainu

Co dělá configure-hermes.sh:

• Hledá API klíč v macOS keychainu (security find-generic-password -s "hermes:api")
• Vytvoří ~/.config/hermes/config.yml
• Nastaví HERMES_API_KEY v shellu

---

📚 Detail ke každému souboru

Brewfile

Seznam všech CLI a GUI aplikací. Spustí se přes brew bundle --file=Brewfile.

Obsahuje:

# CLI (formulas)
brew "fish"       # Defaultní shell
brew "eza"        # ls náhrada
brew "fd"         # find náhrada
brew "bat"        # cat náhrada
brew "btop"       # System monitor
brew "jq"         # JSON parser
brew "ffmpeg"     # Video/audio konverze
brew "deno"       # JavaScript runtime
# ... další

# GUI (casks)
cask "google-chrome"
cask "bitwarden"
cask "obsidian"
cask "visual-studio-code"
# ... další

osx-defaults.sh

Nastaví tyto hodnoty (1:1 kopie tvého aktuálního setupu):

• Finder: AppleShowAllFiles, ShowPathbar, ShowStatusBar, icnv, Date Modified, PfHm
• Dock: magnification, show-recents=0, tilesize=33
• Trackpad: TrackpadRightClick, TrackpadMomentumScroll, TrackpadThreeFingerDrag=0
• Terminal: Clear Dark profil
• TextEdit: NSDocumentSuppressTempVersionStoreWarning

configure-fish.sh

Vytvoří ~/.config/fish/config.fish:

# Aliasy pro docker skripty
alias dk-update="..."
alias dk-backup="..."
alias dk-cleanup="..."

# Zakázání welcome message
set -g fish_greeting ""

# Hermes – zajisti ~/.local/bin v PATH
fish_add_path "$HOME/.local/bin"

install-hermes.sh

• Nainstaluje Hermes přes pip install --user hermes-agent
• Přidá do PATH v ~/.zshrc a Fish config
• Vytvoří aliasy h, hchat, hgit, hd v Fish

configure-hermes.sh

• Hledá API klíč v macOS keychainu (služba: hermes:api)
• Vytvoří ~/.config/hermes/config.yml s:
  • provider: anthropic
  • model: claude-sonnet-4.5
  • sandbox (allow/deny seznam příkazů)
  • integrations.gitea, integrations.docker, integrations.git
• Nastaví HERMES_API_KEY v ~/.zshrc a Fish config

hermes-config.example.yml

Ukázková konfigurace. Slouží jako šablona – reálná konfigurace je v ~/.config/hermes/config.yml (generovaná configure-hermes.sh).

---

🔐 Bezpečnost

• ✅ FileVault – povolit v System Settings → Privacy & Security
• ✅ Firewall – povolit v System Settings → Network → Firewall
• ✅ API klíč Hermes – uložen v macOS keychainu, nikdy v config.yml
• ✅ Hesla NAS – uložena v keychainu, ne v skriptech
• ✅ SSH klíče – passphrase v keychainu

---

🏗 Struktura

mates-macos-setup/
├── README.md                       # Tento soubor
├── LICENSE                         # MIT
├── Brewfile                        # Seznam aplikací
├── osx-defaults.sh                # macOS nastavení
├── configure-fish.sh              # Fish aliasy
├── install-hermes.sh              # Hermes instalace
├── configure-hermes.sh            # Hermes konfigurace
└── hermes-config.example.yml      # Ukázková konfigurace

---

🔄 Aktualizace

# Homebrew
brew update && brew upgrade && brew cleanup

# macOS
System Settings → Software Update

---

📚 Související

• Jotty: knowledge base
• mates-install-scripts: bash skripty pro Docker
• mates-ansible: Ansible pro nový server

---

📜 Licence

MIT – viz LICENSE

---

Poslední update: 2026-08-01