Hermes can search and read bookmarks, create them, tag them and add them
to lists from Telegram. Per Karakeep's MCP README and Hermes's MCP docs:
- the official server image (pinned 0.34.1) runs in a throwaway Podman
container (`podman run -i --rm`), started on first use and stopped
after 10 idle minutes;
- only search/read/create/tag/add-to-list tools are registered (no update
or delete); trust: full because Karakeep doesn't mark its search tools
read-only;
- the API key is in the vault, written to ~/.hermes/.env via the new
hermes_env_secrets, and passed into the container by name.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Models, from the Nov 2026 review (Nous Hermes Index, OpenRouter data):
- chat: openai/gpt-6.1-sol (user's pick), reasoning high (was ultra)
- side tasks (compression, approval, titles, mcp, memory query rewrite,
curator, mail monitor) and unpinned cron: z-ai/glm-5.3-flash
- subagents: deepseek/deepseek-v4.1-flash
- /model aliases: deepseek, haiku
agent.reasoning_effort needs --force (hermes-agent #140221), so settings
can list keys in hermes_settings_force. `config get` exits 1 for unset
keys without a default; that now reads as unset, not a failure.
hermes-model-review: monthly cron job on Sol (pinned, high effort,
continuity) that redoes this research and sends keep/change
recommendations as Ansible keys to Telegram. A script injects the live
model setup and 30-day usage into its prompt. hermes_cron_jobs gains
model/provider, reasoning_effort and continuity.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Non-interactively, `hermes config get` prints only the default for a key
that isn't in config.yaml, so an unset key can't be detected and the play
kept trying (and failing) to unset terminal.cwd. Set it to Hermes's own
default "." instead and drop the unset branch.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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>
Hermes has no auto-update for itself, and /update from Telegram can leave
a launchd gateway offline. Instead, a no-agent Hermes cron job runs
`hermes update --check` on Mondays at 09:07 and messages Telegram only when
a new stable release is out (a failing check sends an error alert).
Adds hermes_cron_jobs (scripts in files/hermes-scripts/, copied to
~/.hermes/scripts/; jobs created when missing) so the deal checker can
follow the same pattern.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Adds a small hermes_settings map that Ansible checks with
`hermes config get` and fixes with `hermes config set`, leaving the rest
of config.yaml to Hermes (its updates migrate that file).
First setting: updates.pre_update_backup: full (was false), so every
`hermes update` zips ~/.hermes first. Rollback isn't supported once a new
version has written state.db, so the backup is the way back.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The dashboard used to be started by hand as `serve --host 0.0.0.0`, so it
was reachable from the LAN and didn't survive a reboot or a Hermes update.
Now, following Hermes's docs:
- launchd agent local.hermes-dashboard runs `hermes dashboard` on
127.0.0.1:9119 (KeepAlive, --skip-build since `hermes update` builds it).
- Tailscale Serve publishes it on https://cogitator-02.porgy-porgy.ts.net,
tailnet only. No module exists for Serve; the task reads
`serve status --json` and only sets it when it differs.
- Login: scrypt password hash and a real signing secret from the vault
(the old secret was the literal text "$(openssl rand -base64 32)"); the
plaintext password line is removed from .env since it overrides the hash.
- After Serve is set, the play checks /api/status demands the basic login;
if not, it turns Serve off and fails.
- Hermes's Python no longer needs a firewall exception, so that's gone.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- pmset: never sleep, no disk sleep, restart after a power cut, wake on
network. The Mac had sleep 1 and only stayed up because BlueBubbles runs
caffeinate.
- Application firewall on, keeping signed software allowed automatically,
stealth and block-all off. Hermes's ad hoc signed Python (dashboard on
9119) is allowed explicitly, since an unattended Mac blocks unsigned
programs silently.
- Local id_ed25519.pub in phil's authorized_keys (already there).
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
cogitator-02 is an Apple Silicon Mac on the tailnet running Hermes Agent.
It gets a `mac` group and mac.yml, kept apart from site.yml so it never
runs with the server's deploys (PLAYBOOK=mac.yml bin/deploy).
The mac role starts by recording the Homebrew taps, formulae and casks
already installed (present only, never upgrades or removes), so the first
run changes nothing.
No passwordless sudo on the Mac: Hermes runs as phil and takes commands
over Telegram. Ansible's sudo password is vault_cogitator02.become_password
and only tasks with become: true use it.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>