Files
ansible/roles/mac/README.md
T
PhilandClaude Opus 5.5 b2e045c9f1 Mac: fix Hermes approval guardian on Haiku 5.5; Bot Chat folder
Hermes's OpenRouter code treats Claude models it doesn't list as
reasoning-mandatory and drops the guardian's "reasoning off" for Haiku
5.5, which then sometimes spends the 16-token budget thinking and
returns nothing, escalating the command to the user. Send
extra_body.reasoning {effort: none} for the approval task; replays of
the failing commands went 21/21 correct.

Also create ~/hermes, the folder the Hermex Bot Chat session works in.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-11 14:56:25 -07:00

4.7 KiB

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. The approval guardian also gets extra_body.reasoning: {effort: none}, because Hermes drops its own "reasoning off" for Haiku 5.5 on OpenRouter. Keys in hermes_settings_force are set with --force (Hermes reads agent.reasoning_effort but config set refuses it, hermes-agent #140221). Also creates ~/hermes, the Bot Chat's folder (the Hermex app's default bot). The session's saved folder was set once by hand; Hermes has no command for it.
  • MCP servers and secrets (also tag hermes-settings): MCP servers are mcp_servers.<name> 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.