skills.rest
diazMelgarejo
diazMelgarejoCOMMUNITY
Explore all skills by this author →
Website𝕏@Melgarejo_yDiazGitHub

hermes-spawn

Start, stop, and check background hermes_harness.py sessions via PID-file lifecycle management.

Updated Mar 22, 2026
Search Tags:#automation#bash#session management#agent lifecycle#hermes#background process#pid file
One-click install
npx skills add https://github.com/diazMelgarejo/orama-system --skill hermes-spawn-diazmelgarejo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hermes-spawn
Source: https://github.com/diazMelgarejo/orama-system/tree/main/bin/orama-system/skills/hermes-harness/commands/hermes-spawn
Command: npx skills add https://github.com/diazMelgarejo/orama-system --skill hermes-spawn-diazmelgarejo

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Managing long-running background Hermes/Perpetua-Tools agent sessions manually is error-prone: stale PID files, duplicate sessions, and unclear status checks. This Skill provides a controlled start/stop/status lifecycle for a background hermes_harness.py process tracked by a PID file, so you can launch long tasks without blocking your current session. ## Core Features & Use Cases - Session Lifecycle Control: Start, stop, or check the status of a background hermes_harness.py session with a single command, with loud failure if a session is already running. - Multi-Session Support: Run concurrent sessions by setting the HERMES_SPAWN_SESSION environment variable to distinct, strictly validated session ids. - Machine-Readable Output: Use the --json flag to get structured status output for scripting and automation. - Use Case: Kick off a long-running task like "summarize open PRs" in the background, then poll its status later without blocking your interactive session. ## Quick Start Ask the agent to start a background Hermes session with a task description, then check its status with the status action.

Frequently Asked Questions about hermes-spawn

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

FAQPage Schema
How do I start a background Hermes agent session?▼

Run the skill with the start action followed by your task description, for example start "summarize open PRs". The script launches hermes_harness.py in the background, verifies it is alive after one second, and writes a PID file.

How do I run multiple Hermes sessions concurrently?▼

Set the HERMES_SPAWN_SESSION environment variable to a distinct session id for each session. The id must match [a-zA-Z0-9_-]; ids containing path traversal or other characters are rejected before anything runs.

Why does the status command exit with a non-zero code?▼

A non-zero exit from status simply means no active session is running for that session id. It is a normal result, not an error to retry, so do not treat it as a failure condition.

Does hermes-spawn load credentials from a dotenv file?▼

No. The skill requires real credentials already present in the process environment and fails clearly if they are missing. It does not perform automatic dotenv loading.

What is the difference between hermes-spawn and Hermes delegate_task?▼

hermes-spawn manages a PID-file-tracked background hermes_harness.py process against Perpetua-Tools (dispatch lane L-PT). It is not the native Hermes delegate_task mechanism (L-H1) and not fleet cursor-agent dispatch (L-Fleet).

Related Skills

Explore More Software Engineering Skills→
Chorus-AIDLCChorus-AIDLC
1.2k

chorus-cli

Installs and configures the chorus CLI to manage agents and call Chorus MCP tools from the shell.

Official
Basic
nq-rdlnq-rdl

jules

Coordinate Jules AI coding sessions to dispatch tasks and collect results.

Official
Advanced
lukacflukacf
19

Shell Patterns

Manages background shell tasks with monitoring, cancellation, and output handling.

Community
Intermediate
supportersimulatorsupportersimulator
2

fleet-dispatch

Dispatch remote tasks to fleet nodes with per-task tracking.

Community
Intermediate