witcheer's Wingtips #69: tool_loop_guardrails

Republished in his own words, with credit.

Back to wingtips

#69 · tool_loop_guardrails

· Security & approvals · CLI / Desktop / Gateway

Hermes Wingtips #69: tool_loop.guardrails

your agent opens a file, reads it, decides to start over, and reads the same file again.

Hermes Agent keeps count of that inside one turn. it watches for three patterns: the same call failing twice in a row, the same tool failing on new arguments, and a call that comes back with the same result while nothing has changed. when a count is reached it writes a warning into the tool result itself, so the model reads it on the next step and changes course.

in the CLI, the TUI and the Desktop app that is where it ends, because you are there to step in. gateway and cron runs go one step further and stop the turn, since nobody is watching. a stop ends the turn, not the session, and the agent tells you which pattern fired.

hermes config set tool_loop_guardrails.hard_stop_enabled true

docs: https://hermes-agent.nousresearch.com/docs/user-guide/configuration#tool-loop-guardrails

All tips are written by witcheer and collected here with credit. Card images stay on his X posts.

witcheer says each tip ran on a real Hermes box before it shipped. Hermes changes fast, so check your version and the linked doc.