Hermes Helper
Use a setup code to connect a Leadtime self-hosted agent to a Hermes Agent runtime.
The Hermes helper connects a self-hosted Leadtime agent to a Hermes Agent runtime. It is a provisioning helper, not a separate agent type.
What the helper configures
- Agent API token: created or reused so Hermes can call Leadtime as the agent.
- Agent sessions: enabled so Leadtime can start work by sending signed webhooks.
- Webhook URL: stored on the agent and pointed at the Hermes connector listener.
- Signing secret: returned once to Hermes so incoming webhooks can be verified.
Setup flow
- Generate a setup codefrom the Hermes helper section in the agent settings.
- Run the setup command near Hermesor give it to an agent that can edit the Hermes installation.
- **Let Hermes claim the code.**Leadtime stores the webhook settings and Hermes stores the returned token, signing secret, API URL, and mode.
After setup
Assign or mention the agent on a task. Leadtime creates an agent session, sends the signed webhook to Hermes, and Hermes starts the configured runtime. Session status and logs are reported back to Leadtime through the public agent-session API.