Event Hooks
Hermes has three hook systems that run custom code at key lifecycle points: System Registered via Runs in Use case Gateway hooks + in Gateway only Logging, aler
Hermes has three hook systems that run custom code at key lifecycle points: All three systems are non-blocking — errors in any hook are caught and logged, never crashing the agent. Gateway hooks fire automatically during gateway operation (Telegram, Discord, Slack, WhatsApp, Teams) without blocking the main agent pipeline. …
What this page covers
- Gateway Event Hooks
- Creating a Hook
- Available Events
- Examples
- Tutorial: BOOT.md — Run a Startup Checklist on Every Gateway Boot
- How It Works
- Plugin Hooks
- Quick reference
- pretoolcall
- posttoolcall
- prellmcall
- postllmcall
- onsessionstart
- onsessionend
- onsessionfinalize
- onsessionreset
- subagentstop
- pregatewaydispatch
- preapprovalrequest
- postapprovalresponse
- transformtoolresult
- transformterminaloutput
- transformllmoutput
- Shell Hooks
- Comparison at a glance
- Configuration schema
- JSON wire protocol
- Worked examples
- Consent model
- The hermes hooks CLI
- Security
- Ordering and precedence
Section outline mirrored from the official Hermes Agent documentation. Follow any heading to read the complete text on the source site.
More in Core Features
Features Overview
Hermes Agent includes a rich set of capabilities that extend far beyond basic chat. From persistent memory and file aware context to browser automation and voic
Tools & Toolsets
Tools are functions that extend the agent's capabilities. They're organized into logical toolsets that can be enabled or disabled per platform. Available Tools
Skills System
Skills are on demand knowledge documents the agent can load when needed. They follow a progressive disclosure pattern to minimize token usage and are compatible
Curator
The curator is a background maintenance pass for agent created skills . It tracks how often each skill is viewed, used, and patched, moves long unused skills th
Persistent Memory
Hermes Agent has bounded, curated memory that persists across sessions. This lets it remember your preferences, your projects, your environment, and things it h
Memory Providers
Hermes Agent ships with 8 external memory provider plugins that give the agent persistent, cross session knowledge beyond the built in MEMORY.md and USER.md. On