hermes-cron-jobs

Create, audit, and troubleshoot scheduled cron jobs in Hermes Agent.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Hermes Agent's cron CLI has undocumented quirks — positional prompt ordering, missing --model flags, and script path rules — that cause silent failures, and diagnosing broken jobs requires knowing where output files and delivery origins actually live. ## Core Features & Use Cases - Correct Job Creation: Enforces the critical argument ordering (prompt immediately after schedule) and explains --script, --skill, --deliver, and agent vs no-agent modes. - Failure Diagnosis: Walks through reading timestamped .md output files, grouping errors by root cause (auth expiry, lock contention, timeouts, daemon-in-cron), and fixing causes instead of individual jobs. - Delivery Auditing & Migration: Shows how to read jobs.json origin fields to audit which chats receive job output and how to move jobs between Hermes profiles. - Use Case: When three cron jobs all fail with the same Google OAuth error, use this Skill to trace the .md output logs, identify the shared root cause, and fix the auth once instead of patching three scripts. ## Quick Start Ask the agent to create a weekday 9am cron job that runs a script and delivers results back to the originating chat.

Frequently Asked Questions about hermes-cron-jobs

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

FAQPage Schema
How do I create a cron job in Hermes Agent?

Run `hermes cron create` with the schedule first, then the prompt as a positional argument immediately after, followed by named flags like `--name`, `--skill`, and `--deliver`. Placing the prompt after named flags fails with an unrecognized arguments error.

Why does hermes cron create fail with unrecognized arguments?

The error occurs when the prompt string appears after named flags instead of immediately after the schedule. The prompt is a positional argument, and flags like `--model` or `--prompt` do not exist on the create command.

How do I find which cron jobs send messages to a specific chat group?

Read `~/.hermes/cron/jobs.json` and search for the target `chat_name` in each job's `origin` object. Jobs with `deliver: origin` send output to that chat, while `deliver: local` jobs run silently.

Where are Hermes cron job output logs stored?

Output is stored as timestamped Markdown files at `~/.hermes/cron/output/<job_id>/<timestamp>.md`, not as stdout or stderr log files. Read the most recent `.md` file to see script output or agent errors.

Why does my cron script time out after 120 seconds?

No-agent scripts have a 120-second hard timeout from the cron scheduler. Common causes include importing accumulated directories, daemon loops that never exit, or hanging API calls from expired auth tokens.

Can I set a per-job model override with hermes cron create?

No, the CLI does not support a `--model` flag. Use the programmatic cronjob tool instead, which accepts a `model` parameter on create and supports model pinning via its update action.