Files
ansible/roles/mac/README.md
T
PhilandClaude Opus 5.5 a92d4c199c Mac: Hermes quick fixes from the setup review
Via hermes_settings (now compared structurally, with null = unset, and a
gateway restart on change):
- timezone America/Denver (was unset)
- auth.adopt_external_logins false: never borrow Claude Code's login
- terminal.cwd unset: stops the /workspace warnings (#140527)
- agent.disabled_toolsets [kanban]: unused, 25 KB of tool schema per call
- skills.write_approval true
- approvals.deny: force-push, curl|sh, dd to devices (docs' examples)
- streaming.enabled true, stt.local.model small
- terminal.container_memory 3072, inside a 4 GB Podman VM (was 2 GB VM
  with a 5 GB container limit), set by a new podman task

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-11 07:17:54 -07:00

49 lines
2.9 KiB
Markdown

# 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`), checked with
`hermes config get` and fixed with `hermes config set` (or `unset` for a
null value); any change restarts the gateway with `hermes gateway restart`.
Covers update backups, timezone, not borrowing Claude Code's login, sandbox
memory, disabled toolsets, skill-write approval, deny rules, streaming and
voice-note transcription. Leave `agent.reasoning_effort` out: `config set`
refuses it without `--force` (hermes-agent #140221).
- **Podman VM** (tag `podman`): `podman_machine_memory` for the VM that runs
Hermes's sandbox. A change stops and restarts the VM.
- **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.
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.