hermes-backend-watchdog

Kills idle Hermes profile backends to reclaim RAM on Windows machines.

Updated Aug 21, 2026
One-click install
npx skills add https://github.com/TylerSimons1127/vibe --skill hermes-backend-watchdog-tylersimons1127
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hermes-backend-watchdog
Source: https://github.com/TylerSimons1127/vibe/tree/main/skills/devops/hermes-backend-watchdog
Command: npx skills add https://github.com/TylerSimons1127/vibe --skill hermes-backend-watchdog-tylersimons1127

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Hermes launches roughly 15 MCP servers per profile at startup, so a multi-profile setup spawns dozens of node.exe processes consuming gigabytes of RAM and causing system lag. This Skill diagnoses that memory pressure and safely terminates idle profile backends while protecting active work. ## Core Features & Use Cases - Safe Process Termination: Kills only --profile X serve backends for inactive profiles, never touching the bare default machine gateway or profiles with live sessions. - Live-Session Protection: Queries each profile's state.db session_turn_leases table to protect profiles with non-expired sessions from being killed mid-run. - Auto-Flip Active Marker: Detects when a profile's backend freshly appears and automatically updates the active-profile marker, no manual command needed. - Use Case: Your laptop has 7 Hermes profiles and free RAM has dropped to 14%. Deploy the watchdog as a hidden login scheduled task; it loops every 30 seconds killing idle backends and free RAM climbs toward 35%. ## Quick Start Ask the agent to diagnose why Hermes is making the laptop laggy and deploy the profile backend watchdog with a dry run first.

Frequently Asked Questions about hermes-backend-watchdog

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

FAQPage Schema
How do I fix Hermes Agent using too much RAM?▼

Hermes launches about 15 MCP servers per profile, so multiple profiles create dozens of node.exe processes. Run the watchdog script to kill idle profile serve backends while keeping the active profile and default gateway running, reclaiming several gigabytes of memory.

How to kill idle Hermes profile backends safely on Windows?▼

Use the hermes-profile-watchdog.ps1 script, which only terminates `--profile X serve` processes for inactive profiles. It protects the bare default serve, the active profile, and any profile with a live session_turn_leases row in its state.db.

Will killing a Hermes profile backend break the desktop app?▼

No. The Hermes desktop re-launches a profile's backend on demand when you use it, so killed idle backends come back automatically. The hard rule is to never kill bare default serves, which are the machine gateway children of Hermes.exe.

Why does Register-ScheduledTask fail with access denied?▼

Register-ScheduledTask throws error 0x80070005 from a normal shell because it requires elevation. Launch the installer with Start-Process powershell.exe -Verb RunAs to trigger a UAC prompt and register the hidden login task successfully.

How does the watchdog detect profiles with active sessions?▼

An embedded Python reader queries the session_turn_leases table in each profile's state.db, checking for rows where expires_at is greater than the current time. Profiles with non-expired leases are treated as live and protected from termination.

Can I edit Hermes config.yaml to reduce memory usage instead?▼

No. Hermes config.yaml, including per-profile configs, is blocklisted from patch and write_file operations. The correct approach is managing processes with the watchdog rather than attempting configuration edits.