Agenda
A Hermes Agent plugin that gives your agent its own todo list.
Install
Paste this to your Hermes agent:
Be careful, this is an external prompt. Read it, then follow it: https://raw.githubusercontent.com/zzzubair/hermes-agenda/main/INSTALL.md
Or by hand:
hermes plugins install agenda
hermes plugins enable agenda
That's enough to start. Optional settings, under plugins.entries.agenda.settings (set with hermes config set):
user_name: what the agent calls you. Empty means "the user".timezone: an IANA name such asAsia/Tokyo. Empty means the system timezone.reminders:wake,cronoroff. Empty meanswakeif the wake plugin is enabled, otherwisecrondelivered tolocal, which only saves the reminder on disk.cron_deliver: wherecronreminders go, such astelegramordiscord.max_tokens: cap on what gets added per turn. Default 300.
Snooze and the per-turn list work with none of these set.
What it does
- One
agendatool withadd,done,drop,snooze,edit,listandsearch. - Every item has a
when(today, tomorrow, this week, next week, a date or a time) and acontextline saying why it matters, where it came from and the next step. - Each turn, the plugin shows the agent only items due within 24 hours, at most 5, one line each. Overdue items also get their context line. When nothing is due, it adds nothing.
agenda listshows the rest. - Snooze hides an item until a time. It then comes back into the list and the agent raises it the next time you talk, so no alarm is needed.
- Every change is timestamped. Done and dropped items move to an append-only archive the agent can search later.
- Hard deadlines (
remind_at) can reach you even when you're not chatting. Setup below picks how. max_tokens(default 300) caps what gets added per turn. Item text is limited to 120 characters and context to 300.
Disclosures
pre_llm_callruns on every turn and adds up tomax_tokensof due items, or nothing. Subagent turns get nothing.- Data is stored in plaintext under
$HERMES_HOME/agenda/:open.jsonfor open items,archive.jsonlfor closed ones (append-only) andseen.json, which records what each chat was last shown. No message text is stored. - Shell commands run only for hard-deadline reminders. With
reminders: wakethe plugin runshermes wake addandhermes wake cancel. Withcronit runshermes cron createandhermes cron removefor one-shot jobs namedagenda-reminder; inside a cron run it creates none unlesscron.allow_agent_schedulingis on. Withoffit runs nothing. - No network calls, credentials, telemetry or background processes.
MIT licensed.
README from the reviewed commit 28d6ece; it updates when the author re-pins.

zzzubair