Skip to content

Put a Dollar Cap on Hermes so an Unattended Job Can't Run Up the Bill

Leave Hermes working overnight and wake up to a bill you did not plan for. A free plugin called budget-leash puts a dollar limit on it. A beginner guide with a screenshot for every step: what the limit does, what it costs and where you set it.

Hermes raises an open palm in a calm stop gesture and holds a small coin purse.

What the dollar cap does, in plain words

Think of a prepaid phone card. When the credit runs out, the calls stop, and no surprise bill arrives at the end of the month. budget-leash gives Hermes the same kind of card.

  • It counts what each job spends on the AI model, and how many actions it takes.
  • At 80 percent of your limit, it tells Hermes to finish up.
  • At 100 percent, Hermes stops: no new action, no new call to the AI model.
  • Hermes can still send you one last message saying why it stopped.

The plugin is listed in the official Hermes Marketplace, made by GitHub user jusst01. We read its page on 14 November 2026.

What it costs

If you use your own AI key, you pay the AI provider directly, as before. The plugin's numbers are an estimate: it guesses the price from a table you can edit. The real amount is always the one on your AI provider's invoice, so keep your provider's own spending limit switched on as well.

Before you start

  • Hermes Agent version 0.22.0 or newer, the one that runs your overnight jobs.
  • A daily amount you are happy to spend, for example 5 dollars.

Step by step: set the cap

Step 1. Open the terminal of your Hermes server and type hermes plugins install budget-leash. Hermes downloads the plugin and asks "Enable 'budget-leash' now?". Type y and press Enter.

The terminal installing budget-leash and asking to enable it

Step 2. If you answered no by mistake, type hermes plugins enable budget-leash.

The terminal enabling the budget-leash plugin

Step 3. Write your own limits in the plugin's settings file, budget-leash.json, inside the hidden .hermes folder of your server. Ours says 1 dollar per job and 5 dollars per day. Change the two numbers to yours and save.

The settings file with a 1 dollar job cap and a 5 dollar daily cap

Step 4. Restart Hermes with hermes gateway restart. This step matters: on our test server the plugin only read the new numbers after a restart.

The terminal restarting the Hermes gateway

Step 5. In your Hermes chat, type /leash report. The reply shows your limits. If it says 1.0 and 5.0, the cap is on.

The /leash report reply showing the new caps of 1.0 and 5.0

Important: a restart keeps the day's total. The plugin writes it to disk, so a job that restarts itself cannot start the day again from zero. Each Hermes profile keeps its own total. To check the cap before a real overnight job, run a short job while you watch /leash.

Frequently asked questions

Will the number match my provider's invoice?
Close, never exact. The plugin estimates. The invoice is the real bill.
What happens when the cap is reached?
Hermes stops taking actions and stops calling the AI model. It can still send you a short message explaining the stop.
Does each Hermes profile have its own cap?
Yes. Each profile keeps its own daily total.
Who makes this plugin?
GitHub user jusst01. It is listed in the official Hermes Marketplace.