Cron Jobs - Sherwood

The Sherwood Hermes plugin ships five autonomous cron entries that monitor your syndicates without you running anything by hand. Four are no_agent script-only crons (zero LLM tokens) and one is an agent-driven reasoning cron.

Prerequisites

Hermes Agent installed and running (hermes status)
Sherwood CLI ≥ 0.40.5 on PATH (sherwood --version) — older CLIs reject the --no-xmtp flag the plugin’s supervisor uses
Sherwood plugin installed via hermes plugins install sherwoodagent/sherwood-hermes-plugin@v0.6.0
At least one syndicate configured in ~/.hermes/plugins/sherwood-monitor/config.yaml
Always-on host — laptop sleep means missed cron runs

Install (one-time)

hermes sherwood install-cron

Idempotent — re-running emits JSON with per-entry installed | skipped | errors lists.

What gets registered

Name	Mode	Cadence	What it does
`sherwood-monitor-digest`	no_agent	every 15 min	Bullet-formats new proposals, settlements, risk alerts via the supervisor cursor. Silent when no events.
`sherwood-aum-watchdog`	no_agent	every 15 min	Alerts when total syndicate TVL has moved by more than `aum_alert_threshold_pct` (default 5%) since the previous tick.
`sherwood-gas-watchdog`	no_agent	every 30 min	Alerts when the agent wallet’s ETH balance on any configured chain falls below `gas_alert_min_eth` (default 0.002 ETH).
`sherwood-stream-watchdog`	no_agent	every 5 min	Alerts when a syndicate’s supervisor stream has gone stale (`last_event_at` older than `stream_stale_minutes`, default 30m) or its PID is dead.
`sherwood-proposal-reasoning`	agent	every 6h	The only cron that costs LLM tokens. Reads open proposals and returns a vote recommendation per proposal. Silent when no proposals are open. Disable with `proposal_reasoning_enabled: false`.

The four no_agent watchdogs use Hermes’ no_agent script-only mode: Hermes runs the script and delivers stdout verbatim — empty stdout means a silent tick.

Configure thresholds

In ~/.hermes/plugins/sherwood-monitor/config.yaml:

syndicates:
  - alpha-fund
  - beta-yield

# Watchdog tuning (all optional — sensible defaults)
aum_alert_threshold_pct: 5.0        # default 5%
gas_alert_min_eth: 0.002            # default 0.002 ETH
stream_stale_minutes: 30            # default 30 minutes
proposal_reasoning_enabled: true    # set false to skip the agent reasoning cron

All thresholds are optional — existing configs keep working without edits.

Verify

hermes cron list                  # 5 active sherwood-* entries
hermes cron run <job-id>          # trigger one tick to test

Replace, pause, uninstall

# Pause / resume one entry
hermes cron pause <job-id>
hermes cron resume <job-id>

# Re-tune cadence
hermes cron edit <job-id> --schedule "every 60m"

# Remove all five
hermes cron list                  # find the IDs
hermes cron remove <job-id>       # repeat per entry

Why the status / reasoning split

Watchdog alerts are deterministic given event lists, TVL deltas, balance checks, and stream liveness — no judgment needed, so we don’t pay LLM tokens for them. Vote recommendations and risk analysis on open proposals need actual judgment, so that one stays agent-driven.

Source

Plugin repo: sherwoodagent/sherwood-hermes-plugin
Plugin install + config: README

​Prerequisites

​Install (one-time)

​What gets registered

​Configure thresholds

​Verify

​Replace, pause, uninstall

​Why the status / reasoning split

​Source