hermes-agent

Manage Hermes Agent gateway lifecycle, platform connections, and WSL troubleshooting.

1|Updated Jun 21, 2026
One-click install
npx skills add https://github.com/tapway/shogun-os --skill hermes-agent-tapway
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hermes-agent
Source: https://github.com/tapway/shogun-os/tree/main/skills/hermes/hermes-agent
Command: npx skills add https://github.com/tapway/shogun-os --skill hermes-agent-tapway

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires google-auth, google-api-python-client, and includes scripts (resource) and references (resource) components.

What problem does it solve? Running the Hermes Agent gateway reliably on WSL is fragile: gateways die silently when chat sessions close, zombie processes block bot tokens, restart commands kill tmux sessions, and config YAML corruption silently reverts to defaults. This Skill provides the operational runbook to start, persist, diagnose, and repair the gateway and its Telegram/Slack/Discord connections. ## Core Features & Use Cases - Gateway Lifecycle Management: Start the gateway in a detached tmux session with a watchdog script that auto-restarts after SIGTERM, crashes, or hermes gateway restart commands. - Failure Diagnosis: Step-by-step fixes for 14+ documented failure modes including zombie processes, slow LLM responses, raw tool-call XML leaking into Slack, PGLite WAL corruption, and config YAML parse errors. - Auto-Start on WSL: Configure .bashrc and Windows Task Scheduler so the gateway survives VM reboots and terminal closures. - Use Case: Your Slack bot stops responding after a gateway restart. Use this Skill to identify the tmux session exit, install the watchdog wrapper, and restore the gateway with auto-recovery in minutes. ## Quick Start Ask the agent to check the Hermes gateway status and restart it inside a tmux session using the watchdog script.

Frequently Asked Questions about hermes-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I keep the Hermes gateway running after closing the terminal?

Run the gateway inside a detached tmux session with the watchdog script: `tmux new-session -d -s hermes-gateway '~/.local/bin/hermes-gateway-watchdog'`. The tmux server is parented by init, so the gateway survives chat session termination.

Why does my Hermes gateway die silently after a few minutes?

The gateway was started as a child of the chat session, so it receives SIGTERM when the session's process group is reaped. Check gateway.log for 'Shutdown context: parent_name=hermes' and restart it inside a dedicated tmux session instead.

How do I fix 'Telegram bot token already in use' errors?

A zombie gateway process still holds the token. Find defunct processes with `ps aux | grep hermes`, kill them with `kill -9 <PID>`, clean up stale tmux sessions, then start a fresh gateway in a new tmux session.

Can the Hermes gateway auto-start when Windows or WSL reboots?

Yes, using two layers: a `.bashrc` snippet that starts the tmux watchdog when any terminal opens, plus a Windows Task Scheduler ONLOGON task that calls `wsl.exe` to launch the watchdog without requiring a terminal.

Why are Slack responses from the gateway slow?

Common causes are `reasoning_effort` forcing chain-of-thought on every message, bloated memory above 90% utilization, and large skill description counts in the system prompt. Set reasoning_effort to empty and add a FAST PATH channel prompt for trivial messages.

What should I not use this Skill for?

Do not use it for cron job management (use hermes-cron-jobs), model or provider configuration (use hermes-model-config), or profile persona authoring (use profile-management). It covers only gateway operations and platform connectivity.