# mac Manages cogitator-02, an Apple Silicon Mac on the tailnet (`mac.yml`, `PLAYBOOK=mac.yml bin/deploy`). - **Homebrew** (tag `homebrew`): taps, formulae and casks listed in `group_vars/mac/main.yml`. Installs what's missing; never upgrades or removes. - **SSH key** (tag `ssh`): your local `~/.ssh/id_ed25519.pub` in phil's `authorized_keys`. Other keys there are left alone. - **Power** (tag `power`): `mac_pmset` in `group_vars/mac/main.yml`: never sleep, power back on after a power cut, wake on network. - **Firewall** (tag `firewall`): macOS's application firewall on, with signed software allowed automatically (SSH, BlueBubbles, AirPlay, Tailscale), no stealth mode and no block-all. Any unsigned program that needs incoming connections has to be allowed explicitly, or the firewall silently blocks it. (Nothing needs that today.) - **Hermes dashboard** (tag `hermes-dashboard`): a launchd service (`local.hermes-dashboard`) running `hermes dashboard` on 127.0.0.1:9119, and Tailscale Serve publishing it at `https://cogitator-02.porgy-porgy.ts.net`, reachable from the tailnet only. Login is username `admin` with the password hash and signing secret from `vault_cogitator02`, written into `~/.hermes/.env` (a plaintext password line there is removed, since it would override the hash). After setting up Serve, the play checks the dashboard demands a login through it; if not, it turns Serve off and fails. - **Hermes settings** (tag `hermes-settings`): the individual keys in `hermes_settings` (`group_vars/mac/main.yml`), compared against `~/.hermes/config.yaml` and fixed with `hermes config set`; any change restarts the gateway (`hermes gateway restart`) and the dashboard. Covers update backups, timezone, not borrowing Claude Code's login, sandbox memory, disabled toolsets, skill-write approval, deny rules, streaming, voice-note transcription, and models: chat on GPT-6.1 Sol, short side tasks (approval, titles) on Claude Haiku 5.5, longer ones and cron on GLM-5.3 Flash, subagents on DeepSeek V4.1 Flash, `/model` aliases. Keys in `hermes_settings_force` are set with `--force` (Hermes reads `agent.reasoning_effort` but `config set` refuses it, hermes-agent #140221). - **MCP servers and secrets** (also tag `hermes-settings`): MCP servers are `mcp_servers.` entries in `hermes_settings`, each running in a throwaway Podman container. Secrets they need are in `hermes_env_secrets` (from the vault) and written to `~/.hermes/.env`. Today: Karakeep, with only search/read/create/tag tools registered, and Kagi's hosted server for web search and page fetching (Hermes's built-in `web` toolset is off). - **Podman VM** (tag `podman`): a launchd job (`local.podman-machine`) that starts the VM running Hermes's sandbox at login, and `podman_machine_memory` for its size. A resize stops the VM and starts it again through that job. The job needs `AbandonProcessGroup`, or launchd kills the VM as soon as `podman machine start` exits. - **Hermes cron jobs** (tag `hermes-cron`): `hermes_cron_jobs` in `group_vars/mac/main.yml`, with their scripts from `files/hermes-scripts/` copied to `~/.hermes/scripts/`. Missing jobs are created; existing ones are left as they are. Today: `hermes-update-notice`, which messages you on Telegram on Mondays only when a new stable Hermes release is out, and `hermes-model-review`, a monthly GPT-6.1 Sol research run that recommends model changes (as Ansible keys) based on the Hermes Index, OpenRouter rankings and prices, and your usage. - **Automatic login** (tag `autologin`): phil is logged in automatically after a reboot, so everything that needs a login session (dashboard, Podman VM, BlueBubbles, Beeper) comes back after a power cut. Uses phil's password from the vault; after changing it, `sudo rm /etc/kcpassword` on the Mac and redeploy. Setting it needs phil logged in at the console: `sysadminctl` only works inside that session (`launchctl asuser`). Ansible logs in as `phil`. sudo needs phil's password, which is in the vault as `vault_cogitator02.become_password`; only tasks with `become: true` use it. phil deliberately doesn't get passwordless sudo, because Hermes Agent runs as phil and takes commands over Telegram. Not managed here: Hermes Agent itself (`~/.hermes`, a self-updating git install on the stable channel, launchd agent `ai.hermes.gateway`), its other settings, and the Tailscale app.