dcf5961b4b4cdb4dc0a56c24625aef89414e7e7f
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_KEYv 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
~/.zshrca Fish config - Vytvoří aliasy
h,hchat,hgit,hdv Fish
configure-hermes.sh
- Hledá API klíč v macOS keychainu (služba:
hermes:api) - Vytvoří
~/.config/hermes/config.ymls:provider: anthropicmodel: claude-sonnet-4.5sandbox(allow/deny seznam příkazů)integrations.gitea,integrations.docker,integrations.git
- Nastaví
HERMES_API_KEYv~/.zshrca 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
Poslední update: 2026-08-01
Languages
Shell
82.2%
Ruby
17.8%