88 lines
5.6 KiB
Markdown
88 lines
5.6 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`), 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` (`hermes_workspace`), the only host folder the
|
|
sandbox sees (`terminal.cwd`, mounted at `/workspace`). The Hermex Bot
|
|
Chat's saved folder points there too; that was set once by hand, since
|
|
Hermes has no command for it. Cua's skill pack is read through
|
|
`skills.external_dirs`, and the `cua-driver` symlink in `~/.hermes/skills`
|
|
is removed (a symlink there empties running sandboxes' skills,
|
|
hermes-agent #53630). After changing `terminal.cwd` or
|
|
`terminal.docker_volumes`, remove the old `hermes-*` Podman containers:
|
|
running ones keep their old mounts.
|
|
The sandbox image is set by its full name (`docker.io/…`): Podman reports
|
|
that form, and with the short name Hermes deleted the sandbox on every
|
|
reuse. For the browser, `~/.hermes/sandbox-chromium`
|
|
(`files/sandbox-chromium`) is mounted where Hermes looks for Chromium; its
|
|
`chrome-linux/chrome` script runs the ARM64 Chromium the image ships
|
|
(hermes-agent #153626). Remove the mount once Hermes finds it by itself.
|
|
- **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), and
|
|
StarPunk's `/mcp` endpoint for notes (OAuth: `hermes mcp login starpunk`
|
|
on the Mac, again every 90 days).
|
|
- **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.
|