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>
49 lines
2.9 KiB
Markdown
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.
|