Skip to content

Esels­brücke

Small helper tools that your agent uses too.

A helper toolbox for Hermes: a dashboard, a today pad, a pomodoro, a billable time log, a world clock and small tools, each with its own switch, that your agent can call for exact answers.

hermes plugins install https://github.com/studioluftbruecke/hermes-eselsbruecke --enable
The Eselsbrücke dashboard in Hermes Desktop: a world clock with five cities, open lines on today's pad, a running pomodoro and time-log timer, and pinned tiles for six small tools.

What it does

The Eselsbrücke today pad with six lines: to-dos, a reminder at 16:30, a line ending in = that shows its result, a note, a finished to-do and a line the agent added.

A today pad that rolls over

Short notes for today. Unchecked lines move to tomorrow, a line can remind you at a time, and a line ending in = shows its result. Your agent sees the pad only when you attach it with @pad:today.

The Eselsbrücke time log: a timer running for one client above a week of entries, with weekly totals in hours and amounts in each client's currency.

Billable time and a pomodoro

Timers per client and project add up to weekly totals and amounts at your hourly rate, with a CSV export, and every entry change can be undone. The pomodoro moves from work to break without a click.

The Eselsbrücke world clock: six cities with their local times and 24-hour bars that mark each place's working hours and the current hour.

A world clock without zone names

Search a city to add it. Each place shows its time, its offset from you and a bar of working hours. A slider moves every row to another time, and Copy as text gives one line for a message.

The Eselsbrücke regex tester with an Ask Hermes button in its header, highlighting three dates and listing the year, month and day each match captured.

Exact answers for your agent

Your agent calls the same tools, so its arithmetic, conversions and formatting come out exact instead of guessed. Every tool page has an Ask Hermes button that drafts the chat for you.

Safe by design

What it touches

  • Its own data folder in your Hermes profile: the toolbox settings and their versions, one pad file per day, the timers, the time log, and your clients and rates.
  • With alerts while Desktop is closed switched on: one Hermes job, eselsbruecke-alerts, and one small script in your profile's scripts folder.

What asks first

  • The agent reads your pad only when you attach it with @pad:today or another @pad reference.
  • The agent adds pad lines and changes time-log entries only when you ask. Each change carries its name and is undone in one step.
  • In scheduled jobs and one-shot runs, the agent's writes to the pad, the timer and the time log are refused.
  • Alerts while Desktop is closed stay off until you switch them on.

What leaves your machine

  • Nothing beyond your own Hermes backend. No account, no credentials, no telemetry.

Disclosures, as written in the README

Also
Network calls: none beyond your own Hermes backend. The Desktop half talks only to this plugin's routes there, including one 2.3 MB download of the token counter's vocabulary when you first ask for an exact count.
Also
Files: everything lives in the plugin's data folder: the toolbox settings and their last 20 versions, one pad file per day, the timers, the time log as one file per week, clients and rates, and CSV files the agent exports.
Also
Scheduled jobs: with alerts while Desktop is closed switched on (off by default), one Hermes job runs every minute without a model and prints only an alert that is due. Hermes delivers it to the profile's home channels. Switching it off removes the job and its script.
Also
Child processes: the regex tester's agent tool runs Python's re in a short-lived child process with a 2 s limit, so a pattern that never finishes cannot hang Hermes. Nothing else starts a process.
Also
Hermes tools it calls: cronjob_manage for the alert job, and kanban_create when you turn a pad line into a card.
Also
Bundled code and data: Prettier, qrcode-generator and js-tiktoken (MIT), the o200k vocabulary (MIT) and the EFF Short Wordlist (CC BY 3.0 US). THIRD_PARTY_NOTICES.md carries each licence.
Credentials: none
Telemetry: none.

Quick start

  1. Install it where Hermes runs.

    hermes plugins install https://github.com/studioluftbruecke/hermes-eselsbruecke --enable

    Hermes on a server and Desktop on your laptop? Install it on the server as above, and on the Desktop computer with:

    hermes plugins install https://github.com/studioluftbruecke/hermes-eselsbruecke
  2. In Hermes Desktop, open Capabilities → Plugins, press Rescan and switch the Desktop half on, then open Eselsbrücke in the sidebar.

  3. Keep the tools you want on the first card and press Done. The dashboard opens with your tools, and Cmd+Shift+E brings it back.

Questions

What do I need?

Hermes 0.23 or newer, and Hermes Desktop 0.23 or newer for the Desktop half. Nothing else: no account, no credentials.

Why the name?

Eselsbrücke is the German word for a memory aid: a little bridge that gets you across.

Does it work without Hermes Desktop?

Partly. Your agent can use the pad, the timers, the time log and the small tools, and @pad references work in any chat. The dashboard, the tool pages and the status-bar chip need Desktop.

Hermes runs on a server. Where do I install it?

In both places, on the same version: on the server for the tools, the routes and the alert job, and on the Desktop computer for the Desktop half. With Hermes and Desktop on one computer, one install covers both.

What leaves my machine?

Nothing from the plugin. What the agent reads from a tool, or a pad you attach, enters its context and reaches your model provider like any tool result.

Can I switch tools off?

Yes. Every tool has a switch in the plugin's settings. A switched-off tool leaves the agent's tool list in the next chat, and every change is saved as a version you can restore.

How do I update?

Run hermes plugins update eselsbruecke where Hermes runs and on the Desktop computer. Then switch Agent in off and on in Capabilities → Plugins, and start a new chat.

How do I uninstall?

Run hermes plugins remove eselsbruecke. If alerts while Desktop is closed were on, also remove the eselsbruecke-alerts job with hermes cron list and hermes cron remove.

Build it with us

Eselsbrücke is open source under MIT. Issues, ideas and pull requests are welcome on GitHub.

The other bridges