Skip to content

Unblock­Brücke

Cards to unblock yourself or your agent.

Cards to unblock yourself or your agent, drawn by you when you are stuck and by Hermes when its tool calls keep failing.

hermes plugins install https://github.com/studioluftbruecke/hermes-unblockbruecke --enable
The UnblockBrücke table in Hermes Desktop: one drawn card asking what all three attempts believed, with Draw, Show agent face, Use in chat and Ask Hermes buttons.

What it does

The card of the day in a small popover: a line for a person, with buttons to show the agent face, use it in chat or ask Hermes.

Two faces on every card

A playful line for you, and one concrete instruction for an agent. Draw one from the UnblockCards page, the status bar, the command palette, or with /card in any chat.

A failed tool result in a Hermes chat with an Agent unblock card attached to it.

Auto-draw for your agent

Switch it on, and Hermes draws a card for itself after three failed tool calls in a row. The call still counts as failed: the card adds a direction and never hides an error.

The UnblockBrücke journal: a list of draws with when, who drew the card, what happened next and its rating.

Decks that learn what helps

Six decks ship with 80 cards: agent, human, coding, design, shaders and writing. A card you mark Helped comes up a little more often, and the journal keeps every draw.

The UnblockBrücke Decks view: every deck with a Draw button and an Auto-draw switch, and the cards of the selected deck.

Write and share your own

Write decks in the page, preview each change before you save it, and restore earlier versions. Propose a deck as a pull request, and every deck is reviewed before it ships.

Safe by design

What it touches

  • Its own data folder in your Hermes profile: your decks, their versions and the journal.

What asks first

  • Auto-draw stays off until you switch it on.
  • In scheduled jobs and single-query runs, the agent cannot change your decks.

What leaves your machine

  • Nothing. No network calls, no credentials, no telemetry.

Disclosures, as written in the README

Network calls: none
The Desktop half talks only to this plugin's routes on your own Hermes backend.
Also
Files: everything lives in the plugin's data folder: your decks and their last 20 versions, the deck switches, and the journal of draws.
Also
Agent context: with auto-draw on, the text of one card from the decks you allow is added to a failing tool result, so the model reads it.
Also
Shell commands, child processes, scheduled jobs: none.
Bundled data: the six decks
The plugin contains no text of the original Oblique Strategies and no data derived from it.
Credentials: none
Telemetry: none.

Quick start

  1. Install it where Hermes runs.

    hermes plugins install https://github.com/studioluftbruecke/hermes-unblockbruecke --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-unblockbruecke
  2. In Hermes Desktop, switch the plugin's Desktop half on in Capabilities → Plugins, then open UnblockCards in the sidebar.

  3. Pick a deck and press Draw, or type /card in any chat.

Questions

What do I need?

Hermes 0.23.0 or newer. Nothing else: no account, no credentials, no network.

Are these the Oblique Strategies?

No. The cards are written new for Hermes, in the spirit of Brian Eno and Peter Schmidt's Oblique Strategies. The original cards are not included.

Does it work without Hermes Desktop?

Yes. /card draws in any chat without a model call, and the agent can draw, show and rate cards with its tools. The UnblockCards page and the card of the day need Desktop.

What leaves my machine?

Nothing from the plugin. A card the agent draws enters its context, and so reaches your model provider like any tool result.

How do I update?

Run hermes plugins update unblockbruecke, then start a new chat. On a server, update there and on the Desktop computer.

How do I uninstall?

Run hermes plugins remove unblockbruecke.

What licence is it under?

The code is MIT. The shipped deck texts are CC BY 4.0, and community decks are CC BY 4.0 or CC0.

Where do I get help?

Open an issue on GitHub.

Build it with us

UnblockBrücke is open source under MIT. Issues, ideas and pull requests are welcome on GitHub. Send a deck: propose it as a pull request. CONTRIBUTING.md explains the file and the rules, and scripts/check_deck.py checks it.

The other bridges