All plugins

uuid-ref

@uuid: context references that decode a UUID or ULID for the model: @uuid:<id> takes a UUID in any common spelling (hyphens or not, braces, upper case, urn:uuid:) or a ULID, and attaches what its bits say, read the way RFC 9562 lays them out: version and variant in words, the creation time a v1, v6, v7 or ULID carries in UTC with how long ago, the clock sequence and node of a v1 or v6 and whether the node is random or looks like a network card (MAC) address, the local id and domain of a v2, a ULID's 128 bits written as a UUID, and the Nil, Max and RFC namespace UUIDs by name; up to 10 identifiers in one reference are compared by creation time; the TUI and Desktop composer preview an identifier as you type it. Disclosure — reads only the text of the reference itself and the system clock, using Python's re, datetime and fractions; nothing is looked up; no network, no files read or written, no subprocess, no credentials read; the plugin keeps no copy of the identifiers, but the @uuid: reference and the decoded text become part of the message sent to your model provider and saved in the session history; register() only adds the @uuid: reference provider.

olric3015Toolsv1.0.0Updated 24 days ago

About

@uuid: context references that decode a UUID or ULID for the model: @uuid:<id> takes a UUID in any common spelling (hyphens or not, braces, upper case, urn:uuid:) or a ULID, and attaches what its bits say, read the way RFC 9562 lays them out: version and variant in words, the creation time a v1, v6, v7 or ULID carries in UTC with how long ago, the clock sequence and node of a v1 or v6 and whether the node is random or looks like a network card (MAC) address, the local id and domain of a v2, a ULID's 128 bits written as a UUID, and the Nil, Max and RFC namespace UUIDs by name; up to 10 identifiers in one reference are compared by creation time; the TUI and Desktop composer preview an identifier as you type it. Disclosure — reads only the text of the reference itself and the system clock, using Python's re, datetime and fractions; nothing is looked up; no network, no files read or written, no subprocess, no credentials read; the plugin keeps no copy of the identifiers, but the @uuid: reference and the decoded text become part of the message sent to your model provider and saved in the session history; register() only adds the @uuid: reference provider.

uuid-ref

@uuid: references for Hermes: put @uuid:017f22e2-79b0-7cc3-98c4-dc0c0c07398f in a message
and Hermes replaces it with what the identifier says about itself, decoded on your machine: its
version and variant in words, the creation time a v1, v6, v7 or ULID carries (in UTC, with how
long ago), the clock sequence and node of a v1 or v6 and whether that node is a real network
card address, the local id of a v2, and the Nil, Max and RFC namespace UUIDs by name.

Many IDs carry a timestamp. A v7 UUID or a ULID in a log line or a database row tells when that
row was created, a v1 also tells which machine made it, and a model reading the hex by eye gets
the bit layout wrong. With @uuid: it gets the exact fields, read the way RFC 9562 lays them
out.

Install

hermes plugins install uuid-ref --enable

Requires Hermes 0.21.5 or newer. No API key, no configuration, no dependencies.

Use

@uuid:017f22e2-79b0-7cc3-98c4-dc0c0c07398f       a UUID in its usual form
@uuid:{919108F7-52D1-4320-9BAC-F847DB4148A8}     braces, upper case, no hyphens, urn:uuid: also work
@uuid:01ARYZ6S41TSV4RRFFQ69G5FAV                 a ULID
@uuid:"<id> <id> <id>"                           up to 10 identifiers, compared by creation time

Several identifiers go in quotes separated by spaces, or unquoted separated by commas.

Example, from the end-to-end test (a one-shot hermes chat turn). The message
When were these rows created? @uuid:017f22e2-79b0-7cc3-98c4-dc0c0c07398f and @uuid:01a1789b-6bb5-73d1-8454-b533b40053b2
reaches the model as the message followed by:

UUID 017f22e2-79b0-7cc3-98c4-dc0c0c07398f
  version  7: Unix time in milliseconds + random bits
  variant  RFC 9562 (the standard layout)
  created  2022-02-22 19:22:22 UTC, about 4.7 years (1,706 days) ago
  clock    1645557742000 ms since 1970-01-01 (48 bits)
  random   74 bits (or a counter in the first 12, as some makers do)
Notes
  - sorts by creation time, as text and as bytes

UUID 01a1789b-6bb5-73d1-8454-b533b40053b2
  version  7: Unix time in milliseconds + random bits
  variant  RFC 9562 (the standard layout)
  created  2026-10-26 14:26:54.005 UTC, 11 seconds ago
  clock    1793024814005 ms since 1970-01-01 (48 bits)
  random   74 bits (or a counter in the first 12, as some makers do)
Notes
  - sorts by creation time, as text and as bytes

What each kind shows:

  • v1 and v6 (time-based): the creation time to 100 nanoseconds, the clock sequence, and the
    node. A node with its multicast bit set is random; one without it looks like a network card
    (MAC) address, and the notes say the UUID tells which machine made it.
  • v7: the creation time to the millisecond.
  • v2 (DCE Security): the local id (a POSIX uid or gid) and its domain, and the time to within
    about 7 minutes, since the id takes the place of the low clock bits.
  • v3 and v5 (name-based): that they are MD5 or SHA-1 hashes of a namespace and a name, which
    cannot be read back.
  • v4 (random) and v8 (custom): the version, nothing more to read.
  • ULID: the creation time to the millisecond, and the same 128 bits written as a UUID, the
    way a UUID database column stores a ULID.
  • The Nil and Max UUIDs, the four namespace UUIDs from RFC 9562 (DNS, URL, ISO OID,
    X.500 DN), and UUIDs of the NCS, Microsoft and reserved variants, whose bits are not read
    further.

A time in the future (more than a minute ahead) or before 1970 is noted: the maker's clock was
off, or the bits were not made from a clock. With several identifiers, a last section says how
far apart their creation times are.

Errors say what is wrong (a UUID has 32 hex digits (36 characters with hyphens); ... has 31,
ULIDs leave out I, L, O and U) and reach the model under Hermes's context warnings.

Suggestions

In the TUI and the desktop app, @uuid: followed by an identifier previews it as a suggestion
(v7, created 2022-02-22 19:22:22 UTC, about 4.7 years (1,706 days) ago, v4, random); the
suggestion inserts the identifier in its usual form. The classic CLI does not show reference
suggestions.

What it does not do

uuid-ref reads the bits of the identifier you give it. It does not look anything up: a v3 or v5
name cannot be recovered, a MAC address is not matched to a vendor, and a creation time is only
what the maker's clock said.

Security and footprint

  • register() only registers one context reference provider (@uuid:).
  • It reads nothing but the text of the reference itself and the system clock, and only when you
    write @uuid: in a message.
  • No network access, no subprocesses, no downloads, no credentials read, no files read or
    written. The plugin keeps no copy of the identifiers, but the @uuid: reference and the
    decoded text become part of the message sent to your model provider and saved in the session
    history.
  • Standard library only (re, datetime, fractions).

Development

python -m pytest tests                                          # unit tests, no Hermes needed
PYTHONPATH=<hermes checkout> python tests/e2e/uuid_ref_e2e.py   # real hermes chat turns and TUI suggestions
hermes plugins validate uuid-ref

Changes

  • 1.0.0: first release.

MIT licensed.

README from the reviewed commit 12882e9; it updates when the author re-pins.

More by olric3015

18 plugins by olric3015 in the catalog.

olric3015approval-ledgerLocal ledger of Hermes's approval prompts (dangerous commands, protected writes, MCP consent, smart-mode verdicts): /approval-log shows how often each rule asked, how many prompts were approved, denied or left unanswered, and how long a person took to answer, per rule, per surface or per day, for the last 24 hours, any number of hours or days, the latest session or everything recorded; /approval-log recent lists the newest decisions (ten, or up to 100 with /approval-log recent 50). Disclosure — writes decision metadata (session id, surface, rule label, answer, timings; no command, description or session key) to plugin-data/approval-ledger/approvals.jsonl, trimmed to 5,000 rows past 2 MB; observer only, cannot answer or change an approval; no networkCommunitytoolsolric3015aux-ledgerLocal ledger of Hermes's auxiliary LLM calls (titling, compression, vision, approval): /aux shows tokens, time and failures per task, model, provider or day, or lists the newest calls (ten, or up to 100 with /aux recent 50), for the last 24 hours, any number of hours or days, the latest session or everything recorded. Disclosure — writes auxiliary-call metadata (ids, models, timings, token counts, no prompt or response text) to plugin-data/aux-ledger/calls.jsonl, trimmed to 5,000 rows past 2 MB; no networkCommunitytoolsolric3015b64-ref@b64: context references that decode encoded text for the model: @b64:<value> takes base64 (standard or URL-safe, padded or not), hex (0x48656c6c6f, 48:65:6c, \x48\x65), percent-encoding or a data: URI, told apart by the value's shape or picked with base64:, base64url:, hex: or url:, and attaches what it holds: text as text with control and invisible characters escaped, JSON pretty-printed, gzip and zlib inflated in memory (at most 1 MiB, one layer), and binary named by its format (PNG and GIF with their size, JPEG, PDF, ZIP, ELF, SQLite and more) with a hex dump of its first 128 bytes; notes point out a value that was cut short, padding that is off, a second layer of encoding and a JWT inside; the TUI and Desktop composer preview a value as you type it. Disclosure — reads only the text of the reference itself, using Python's base64, json, urllib.parse and zlib; nothing decoded is run, opened or saved; no network, no files read or written, no subprocess, no credentials read; the plugin keeps no copy of what it decodes, but the @b64: reference and the decoded contents become part of the message sent to your model provider and saved in the session history, so decode only values you are willing to share with it; register() only adds the @b64: reference provider.Communitytoolsolric3015chmod-ref@chmod: context references that explain a file permission mode for the model: @chmod:<mode> takes an octal mode (755, 0755, 4755), ls -l text (-rwsr-xr-x, with the file type letter and a trailing + . or @) or an st_mode as stat and git write it (100644), and attaches both forms, each class's rights in words (directory rights named as such), what setuid, setgid and the sticky bit do and where they are ignored, and notes such as a mode everyone can change, one private to the owner, or a class holding rights the class before it lacks; @chmod:"644 u+x,go-w" applies a symbolic change step by step the way GNU chmod does (u g o a, + - =, r w x X s t, copies like u=g), @chmod:"100644 100755" shows what changes between two modes, and @chmod:"umask 027" shows what new files and directories get; the TUI and Desktop composer preview a mode as you type it. Disclosure — reads only the text of the reference itself, using Python's re; it never looks at a file on disk; no network, no files read or written, no permission changed, no subprocess, no credentials read; the plugin keeps no copy of what you write, but the @chmod: reference and the explanation become part of the message sent to your model provider and saved in the session history; register() only adds the @chmod: reference provider.Communitytools

Developer Mode

Explore built-in Hermes toolsets and actions.

HermesAgent

Developer?

Create a Hermes extension for Desktop or agent workflows.

Developer Section