Skip to main content

​
Overview

CommandDescriptionCost
naive cron create <schedule> <prompt>Create a new scheduled jobFree (cost on each firing)
naive cron listList all cron jobsFree
naive cron trigger <id>Manually trigger a job nowCredits (based on work)
naive cron pause <id>Pause a cron jobFree
naive cron remove <id>Delete a cron job permanentlyFree

​
How It Works

Cron jobs are managed through the Hermes gateway’s native Jobs API (/api/jobs). Each firing sends a prompt to the CEO, which creates tasks and dispatches them to employees. This enables automated recurring workflows like weekly reports, daily email checks, or scheduled social media content.

​
Create a Cron Job

naive cron create "0 9 * * *" "Check email and respond to urgent messages"
naive cron create "0 */6 * * *" "Monitor social media mentions" --skill naive-social
naive cron create "0 0 * * 1" "Generate weekly analytics report" --name "Weekly Report"

​
Options

FlagDescription
--skill <name>Skill to invoke (e.g., naive-social, naive-email)
--name <name>Human-readable name for the job

​
Schedule Format (Cron Expression)

ExpressionMeaning
0 9 * * *Every day at 9:00 AM UTC
0 */6 * * *Every 6 hours
0 9 * * 1Every Monday at 9:00 AM UTC
0 0 1 * *First day of every month at midnight
*/30 * * * *Every 30 minutes

​
Output

{
  "success": true,
  "action": "cron.create",
  "result": {
    "id": "cron-abc-123",
    "schedule": "0 9 * * *",
    "name": "Weekly Report",
    "status": "active"
  },
  "hints": [
    "Cron job created (id: cron-abc-123)",
    "Schedule: 0 9 * * *",
    "The job will fire automatically at the next scheduled interval"
  ]
}

​
List Cron Jobs

naive cron list
Returns all cron jobs with:
  • ID, name, schedule (cron expression)
  • Status (active, paused)
  • Prompt that fires on each run
  • Last run timestamp and result
  • Next scheduled run time

​
Trigger Manually

Fires the job immediately, regardless of schedule. The regular schedule is not affected. 
naive cron trigger cron-abc-123

​
Pause a Job

naive cron pause cron-abc-123
The job remains configured but will not fire on schedule. You can still trigger it manually with naive cron trigger.

​
Remove a Job

naive cron remove cron-abc-123
Permanently deletes the cron job. Past executions remain in history. Cannot be undone.

​
Typical Workflow

# 1. Create a recurring job
naive cron create "0 9 * * *" "Check inbox and summarize new emails"

# 2. Test it immediately
naive cron trigger cron-abc-123

# 3. View all jobs
naive cron list

# 4. Pause if needed
naive cron pause cron-abc-123

# 5. Delete when done
naive cron remove cron-abc-123