skills.rest
SillyHippy
SillyHippyCOMMUNITY
Explore all skills by this author →
GitHub

hermes-gateway

Start, stop, restart, and monitor the Hermes AI agent gateway service.

Updated Sep 5, 2026
Search Tags:#sqlite#service management#gateway#telegram#hermes#watchdog#auto-repair
One-click install
npx skills add https://github.com/SillyHippy/zo-skills --skill hermes-gateway-sillyhippy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hermes-gateway
Source: https://github.com/SillyHippy/zo-skills/tree/main/skills/hermes-gateway
Command: npx skills add https://github.com/SillyHippy/zo-skills --skill hermes-gateway-sillyhippy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Managing the Hermes AI agent gateway — the messaging service connecting Hermes to Telegram and other platforms — requires manual process control and recovery from SQLite state.db corruption, which this Skill automates. ## Core Features & Use Cases - Gateway Lifecycle Control: Start, stop, restart, check status, and install the Hermes gateway as a boot-time service via shell scripts. - state.db Corruption Auto-Repair: A watchdog probes SQLite integrity and write round-trips, runs deterministic FTS-disable healing, and escalates to a dispatched Zo repair agent when healing fails. - Durable State Sync: Keeps the live tmpfs state.db backed up to a durable path using the SQLite online backup API to survive reboots and avoid 9p filesystem corruption. - Use Case: When the user says "start Hermes" or the gateway's state.db reports btreeInitPage corruption, this Skill restarts the service and auto-heals the database without manual intervention. ## Quick Start Ask the assistant to start the Hermes gateway and check its status using the hermes-gateway control script.

Frequently Asked Questions about hermes-gateway

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

FAQPage Schema
How do I start or stop the Hermes gateway?▼

Run the hermes-gateway.sh script with start, stop, restart, or status arguments to control the gateway process. The script checks whether the gateway is already running before acting and reports success or failure.

How do I fix SQLite state.db corruption in Hermes?▼

Run the disable-fts-permanent.py script to drop FTS5 triggers and tables, then sync the durable copy and reboot the gateway. The watchdog automates this flow and escalates to a repair agent if healing fails.

Does the Hermes gateway restart automatically after a crash?▼

Yes, a cron job checks every 5 minutes whether the gateway process is running and restarts it if stopped. A separate watchdog script also loops to relaunch the gateway when the process disappears.

Why does Hermes state.db get corrupted on 9p filesystems?▼

SQLite WAL writes on 9p mounts cause corruption under concurrent chats, so the boot script moves state.db to tmpfs at /dev/shm and symlinks it. A durable copy is synced back to disk using the SQLite online backup API.

Can the Hermes gateway persist across system reboots?▼

Yes, running the script with the install argument registers the gateway as a boot-time service. On boot, the boot script restores the durable state.db snapshot into tmpfs before launching the gateway.

Related Skills

Explore More Software Engineering Skills→
unclehowellunclehowell

hermes-telegram-fix

Fix Telegram 401 and gateway lock conflicts in Hermes multi-agent deployments.

Community
Intermediate
Xipher-LabsXipher-Labs
6

alerting-stack

Define Telegram-based alerting for uptime, VM, LLM spend, and Hetzner cost monitoring.

Official
Intermediate
mupengi-botmupengi-bot
11

health-monitor

Monitor OpenClaw processes, CDP connectivity, disk usage, Git status, and cron jobs.

Community
Advanced
genfeedaigenfeedai
2

docker-expert

Automates Docker containerization and deployment setups for NestJS and Next.js apps.

Official
Advanced