Hermes Runtime
Entry point for the Hermes companion runtime. Detailed per-subcommand argument and UX notes live in commands/ (chat, run, status, jobs, setup).
Helper
node "${CLAUDE_PLUGIN_ROOT}/skills/misc/hermes-runtime/scripts/hermes-companion.mjs" <subcommand> <args>
Subcommands:
setup [--json]— check connectivity (auto-detects local vs SSH mode)chat <message> [--stream] [--system <prompt>] [--json]— send message to Hermesrun <task> [--background] [--json]— start async run with event streamingstatus [job-id] [--json]— check connection/job statusjobs [list|delete <id>] [--json]— manage cron jobstunnel [start|stop|status]— manage SSH tunnel directly
Rules
- Always use the helper. Never hand-roll SSH, curl, or HTTP commands.
- Return stdout verbatim — no paraphrasing, no summarizing.
- Do not inspect files, monitor progress, or do follow-up work.
- On connectivity failure, suggest running the
setupsubcommand ("hermes setup").
Connection modes
- auto (default) — tries localhost:8642 first, then SSH tunnel
- local — direct connection to localhost:8642
- ssh — SSH tunnel to remote host (default
arch) - Config file:
~/.claude/hermes/config.json