Hermes Agent setup — config, skills, patches, cron (Mac Mini-only)
This repository also configures its own agents. See what hermes-agent tells them →
Skill Claude CodeCodex
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 $HOMELABAPIKEY.
Skill Claude CodeCodex
TTS audio synthesis via the agent-workflows audio door (http://127.0.0.1:7792/v1) — Gemini 3.8 Flash TTS for briefings/long-form (prepped, titled), Gemini 3.8 Flash-Lite for short replies, voice "Charon", OpenAI-compatible /v1/audio/speech. Use for any spoken output: morning/evening briefings, voice memos, ad-hoc TTS.
Skill Claude CodeCodex
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.
Skill Claude CodeCodex
Diagnose Hermes's own gateway — "are you healthy", "why do I see so many gateway shutting down messages", model-routing failures, reasoning-effort or function-tool rejections from the IU endpoint, Slack or API-server connectivity, a config change that appears not to take effect. Separates supervisor health from…
Skill Claude CodeCodex
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…
Skill Claude CodeCodex
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…
Skill Claude CodeCodex
Persist and share an image Hermes has received (Slack upload) or generated, via imgcli — private by default (durable copy in the bucket's private/ prefix + a time-limited presigned link), public CDN only when Johannes explicitly wants a shareable public link. Use when an image needs a durable home or a URL to hand out.
Skill Claude CodeCodex
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 $KARAKEEPAPIKEY.
Skill Claude CodeCodex
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.
Skill Claude CodeCodex
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…
Skill Claude CodeCodex
Answer and maintain Johannes's Wild Rift (mobile MOBA) champion pool — eleven champions across jungle, support, mid and baron — from the curated build/rune/matchup notes in the Obsidian vault, refreshing them from the web via agw-research when a patch moves. Use for "refresh my build", "baue mir den Rammus build neu"…
Skill Claude CodeCodex
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…
Skill Claude CodeCodex
Triage OpenTelemetry traces/logs/metrics in ClickStack/HyperDX (VPS-only) through agw hdx / agw otel (agent-workflows) — never the browser UI, which needs an interactive login you cannot provide. Use when a HyperDX-authored alert lands in.
Skill Claude CodeCodex
Turn source notes (a brain note, a saved article, pasted text) into a long-form, two-host German podcast episode via agw podcast (agent-workflows), and publish it into Audiobookshelf. Use when Johannes asks for "mach mir einen Podcast", "Podcast über …", "als Podcast", "Hörbuch/Audio-Briefing zu …", "mach daraus was…
Skill Claude CodeCodex
Use when an agent needs a present human. Drain its queue.
Skill Claude CodeCodex
Open, inspect and steer herdr panes, tabs and workspaces on this mini — Johannes's own visible terminal workspace. Use when he explicitly names herdr or asks for a pane/tab/agent there ("mach einen herdr tab auf", "starte eine pane in mit cf", "open a herdr pane", "schreib das in eine pane", "schau in die pane von "…
Skill Claude CodeCodex
One checklist before you relay or act on a claim — a finished agent episode, a "fixed" status, a defect report, a deploy that "went out". Use whenever something was reported to you rather than observed by you, or before saying "done", "live" or "fixed" to Johannes.
Skill Claude CodeCodex
Run a longer written artifact through the platform's prose pass (agw prose-polish) before it is delivered — vault pages, reports, articles, docs, briefings Johannes reads as text. Use after drafting anything longer than a short chat reply. Not for chat replies, not for TTS scripts.
Skill Claude CodeCodex
Deep, cited web research via agw research (agent-workflows) — agentic web search + page fetch + library docs, 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"…
At most 3 mods per repository are shown here, and a mod shipped inside a plugin is left to that plugin's page — the rest are on their repository pages: