hermes-agent

Hand repo work to a bounded Claude Code episode via the `hermes-cc.sh` verb dispatcher, then answer with its verdict. Use when triage needs the actual source — "why is X failing, look in the repo", "what changed in Y", "warum ist Z rot, schau ins repo", "read the code and tell me", "check the repo for", a red monitor whose cause is code-shaped, a stale GitHub issue, or any question you can only answer by guessing otherwise. Also the path for "file an issue about what you find" (author tier) and, only with Johannes's explicit confirmation, "make that change" (implement tier — isolated worktree, draft PR), then "merge it" to land that PR.

Update Hermes Agent to latest version, resolve conflicts in locally-modified source files, and restart the gateway

Test, observe, and improve Hermes Agent behavior — send test messages, read session traces, identify routing failures, and fix SOUL.md/SKILL.md

Read, search, and write Johannes's Obsidian vault (the PARA second brain at ~/SourceRoot/brain) via the Obsidian CLI (metadata-aware — backlinks, tags, Dataview) with a filesystem fallback. Capture notes to the inbox, create resource/inspiration notes with the right frontmatter, search by text/tag/backlink.

Diagnose and remediate homelab / VPS / Mac Mini infrastructure through the bounded `hermes-ops.sh` verb dispatcher — monitors down, unhealthy or restart-looping containers, cron failures, push-monitor heartbeat gaps, uptime-kuma config corruption, deploy drift. Read-only triage is free; every mutation is a named verb needing --confirm and --why. Use for "#alerts" messages, "what's down", "is everything up", "why is X red", "restart Y", "redeploy Z".

Call the argo REST API (https://argo.jkrumm.com/api) for TickTick tasks, Gmail, Calendar, Docker (homelab + VPS), UptimeKuma, Slack, weather, Garmin Health, Strength tracking, WalkingPad treadmill stats, AI usage/cost, user profile, and read-only SQL — use curl with Bearer $HOMELAB_API_KEY

TTS audio synthesis via the VPS audio-gateway (https://audio-gateway.jkrumm.com/v1) — Gemini 3.1 Flash TTS, voice "Charon", OpenAI-compatible /v1/audio/speech. Use for any spoken output: morning/evening briefings, voice memos, ad-hoc TTS.

Recommend what Johannes should read next — personal book recommender grounded in his actual taste. Use when he asks "what should I read", wants book recommendations, wants to find his next novel, wants fiction, fantasy, sci-fi, thriller, or travel/adventure picks, or wants to turn his reading history into picks. Pulls taste from the Argo Reading API (Hardcover shelf — ratings, genres, read / want-to-read) + a durable taste profile in Obsidian, researches real matching books on the web, ranks them, and captures picks back to Obsidian.

Homelab operations that are not incident response — public file sharing via DUFS (public.jkrumm.com), torrent → Jellyfin filesystem moves, qBittorrent queries, VPN-stack container recovery. Use when the user asks about downloads, the Jellyfin library, moving media, or wants a file hosted publicly (prefer own DUFS over third-party hosts). For monitoring, alert diagnosis, and infra mutation, use `homelab-ops` instead.

Persist and share an image Hermes has received (Slack upload) or generated, via `imgcli` — private image-share by default (durable homelab copy + admin URL), public CDN only when Johannes explicitly wants a shareable public link, or a friend-shareable token link for an image already in the private layer. Use when an image needs a durable home or a URL to hand out.

Capture a todo, reminder, or issue from natural language and route it — TickTick (Personal/Work/Shopping) or GitHub Issue on the right repo. Single entry point for "remind me to…", "I should…", "todo:", "issue:" intents

Deep, cited web research via the research-gateway — agentic Tavily + Context7 + page-fetch, cross-verified, returns a cited markdown report. Use when Johannes wants facts looked up and *verified now* — "research X", "recherchier mal", "compare A vs B", "what's the latest on Y", "is it true that Z", "best practices for…", or any library / version / API / migration question. Preferred over raw web search for anything substantive. Submit-and-poll (async); runs on EU/IU models, off Max.

IU work surface — Outlook calendar, Teams chats/channels + curated alerts, Jira tickets/sprint/backlog (read + create/update/comment on Johannes's behalf, always Team=Prometheus), Confluence docs, GitLab MRs + approvals + discussions. Cross-system identity via /m365/team roster. Personal assistant only, never team-facing.

Save links and notes to KaraKeep (self-hosted read-it-later / bookmark "everything bucket") and query them — keep a URL or text, full-text search, manage lists (incl. smart lists) and tags, read AI summaries and highlights. Use curl with Bearer $KARAKEEP_API_KEY.