All plugins

year-wrapped

Your year with your agent as shareable story cards. hermes year-wrapped (terminal) and /year-wrapped (every surface) read your own history and write 13 cards, 1080x1920, each in its own colour: persona (16 types from four axes: night or day, build or ask, terminal or chat, one model or many, with the real shares printed on the card), top tools, most used skill, manners and swear jar, night shift, longest chat, tokens processed, night crew (cron jobs and subagents), main model, projects started vs. archived, word of the year and a black and gold summary. Session titles are hidden unless --show-titles; client names can be excluded or shown under a code name (exclude_words, rename_words). No cost figures. English and German. Disclosure: no network calls, no model calls, standard library only. Reads state.db and, if present, projects.db of the active profile read only (mode=ro); never writes to them. Writes the cards as self-contained HTML (no scripts, no external assets) plus an index.html under HERMES_HOME/plugin-data/year-wrapped/<period>/ or the folder given with --out. The terminal command hermes year-wrapped renders PNG files by starting a locally installed headless Chrome, Chromium, Edge, Brave or Playwright headless shell (or the one set in browser_path) as a subprocess that opens only the local card files; --no-png skips it, and /year-wrapped in a chat never starts a browser. Nothing is downloaded. No credentials, no hooks, no tools, no cron jobs, no background processes, no telemetry.

MadeByBrain1Generalv1.0.0Updated 5 days ago

About

Your year with your agent as shareable story cards. hermes year-wrapped (terminal) and /year-wrapped (every surface) read your own history and write 13 cards, 1080x1920, each in its own colour: persona (16 types from four axes: night or day, build or ask, terminal or chat, one model or many, with the real shares printed on the card), top tools, most used skill, manners and swear jar, night shift, longest chat, tokens processed, night crew (cron jobs and subagents), main model, projects started vs. archived, word of the year and a black and gold summary. Session titles are hidden unless --show-titles; client names can be excluded or shown under a code name (exclude_words, rename_words). No cost figures. English and German. Disclosure: no network calls, no model calls, standard library only. Reads state.db and, if present, projects.db of the active profile read only (mode=ro); never writes to them. Writes the cards as self-contained HTML (no scripts, no external assets) plus an index.html under HERMES_HOME/plugin-data/year-wrapped/<period>/ or the folder given with --out. The terminal command hermes year-wrapped renders PNG files by starting a locally installed headless Chrome, Chromium, Edge, Brave or Playwright headless shell (or the one set in browser_path) as a subprocess that opens only the local card files; --no-png skips it, and /year-wrapped in a chat never starts a browser. Nothing is downloaded. No credentials, no hooks, no tools, no cron jobs, no background processes, no telemetry.

year-wrapped: your year with your agent

year-wrapped: story cards from your own Hermes history

Spotify has Wrapped. Your agent has a year too. hermes year-wrapped reads your own Hermes history and turns it into colourful story cards (1080 x 1920) you can post:

CardWhat it shows
Coverchats, active days, messages you typed
Your typeone of 16 personas from four axes, with the real shares behind it
Top toolsyour five most used tools
Most used skillthe skill your agent loaded most, plus the next four
Mannersplease and thank you count, the swear jar and your rank
Night shiftyour latest message (closest to dawn) and how many came after 10 PM
Longest conversationthe marathon chat compared with your average
Tokenswhat your agent processed, measured in Harry Potter books
Night crewcron jobs and subagents that worked without you
Main modelyour favourite model, who you cheated with, relationship status
Projectsprojects started vs. archived
Word of the yearthe word you typed in the most messages
Summaryblack and gold, the one people post

All 13 cards from one real history, 2026

Cards are self-contained HTML. When a headless Chrome or Chromium is installed, PNG files are rendered too. Everything is counted locally and read only. No model calls, no network, no telemetry.

Not to be confused with

hermes-wrapped by devpras22 turns your week with Hermes into a 30 second video every Sunday. year-wrapped is the yearly, card based counterpart: static story cards, no video renderer, no cron job. Both can be installed side by side.

Who it is for

  • Everyone who uses Hermes every day and wants to see what that looks like after a year.
  • People who share their setup. The cards are built for stories and feeds, and every card says that nothing was uploaded.
  • Teams and trainers, as a starting point. It is a light way to start a conversation about how people work with their agent. It is not an analytics product: one profile, one machine, rough counts.

Beyond this plugin

year-wrapped is free and stays free. Real usage reviews for a company need its own data and roles, so they are not a public plugin:

  • dashboards across all users and profiles of a company instance;
  • cost reports from the provider bills instead of estimates;
  • reviews that show where a team loses time, which skills pay off and which are never used.

MadeByBrain, the maintainer of this plugin, plans and builds such Hermes setups for businesses.

Install

hermes plugins install MadeByBrain/hermes-extensions/plugins/year-wrapped --enable

Pin a release with --ref <40 character commit SHA> (tags are not accepted by --ref).

Use it

hermes year-wrapped                          # this calendar year
hermes year-wrapped --year 2026
hermes year-wrapped --days 30
hermes year-wrapped --all
hermes year-wrapped --lang de                # en or de; default: setting, then auto
hermes year-wrapped --tz Europe/Berlin       # hours and days in your timezone
hermes year-wrapped --show-titles            # show the session title on the marathon card
hermes year-wrapped --rename acme=Northstar  # show a word under a code name (repeatable)
hermes year-wrapped --out ~/wrapped          # write the cards somewhere else
hermes year-wrapped --no-png                 # HTML only
hermes year-wrapped --json                   # raw numbers, no cards

Cards land in <HERMES_HOME>/plugin-data/year-wrapped/<year>/ as 01-cover.html, 01-cover.png and so on, plus index.html with all cards side by side.

In any chat, /year-wrapped prints the summary and writes the HTML cards (/year-wrapped 2025, /year-wrapped 30, /year-wrapped all, /year-wrapped json). PNG rendering is left to the terminal command, so a chat never starts a browser.

Example summary (one real history, German setting):

Year Wrapped 2026
890 Chats, 7.609 Nachrichten von dir, 124 aktive Tage
Dein Typ: Der gesprächige Bauleiter (DAY·BLD·CHT·MLT)
Top-Tool: terminal (34.838x)
Top-Skill: hermes-agent (140x)
Hauptmodell: Claude Opus (441 Chats)
Wort des Jahres: hermes (591 Nachrichten)
Manieren: 1.300x höflich, Schimpfglas 3
Späteste Nachricht: 01:30 am 13. August
Jobs, die ohne dich liefen: 11.728
Projekte angefangen: 29, archiviert: 3

The 16 types

Four axes, each decided by a real share from your history. The persona card prints all four shares, so nobody has to trust a made up score.

AxisLetterRule
Night or dayNGT / DAYNGT when at least 20 % of your messages were typed between 22:00 and 05:59
Build or askBLD / ASKBLD when in at least half of your chats the agent ran commands or wrote files (terminal, patch, write_file, execute_code, skill_manage, delegate_task and similar)
Terminal or chatTRM / CHTTRM when at least half of your messages came from the CLI or TUI
One model or manyONE / MLTONE when at least 75 % of your chats used the same model family
CodeEnglishDeutsch
NGT·BLD·TRM·MLTThe 3 AM ArchitectDer 3-Uhr-Architekt
NGT·BLD·TRM·ONEThe Midnight MechanicDer Mitternachtsmechaniker
NGT·BLD·CHT·MLTThe Insomniac ForemanDer schlaflose Polier
NGT·BLD·CHT·ONEThe Moonlight BuilderDer Mondschein-Baumeister
NGT·ASK·TRM·MLTThe Nocturnal InterrogatorDer nächtliche Verhörer
NGT·ASK·TRM·ONEThe Terminal OwlDie Terminal-Eule
NGT·ASK·CHT·MLTThe 2 AM PhilosopherDer 2-Uhr-Philosoph
NGT·ASK·CHT·ONEThe Late Night ConfidantDer Mitternachts-Vertraute
DAY·BLD·TRM·MLTThe Model JugglerDer Modell-Jongleur
DAY·BLD·TRM·ONEThe Clockwork BuilderDer Uhrwerk-Baumeister
DAY·BLD·CHT·MLTThe Chatty ContractorDer gesprächige Bauleiter
DAY·BLD·CHT·ONEThe Steady ForemanDer verlässliche Vorarbeiter
DAY·ASK·TRM·MLTThe Benchmark TouristDer Benchmark-Tourist
DAY·ASK·TRM·ONEThe Command Line MonkDer Kommandozeilen-Mönch
DAY·ASK·CHT·MLTThe Model SommelierDer Modell-Sommelier
DAY·ASK·CHT·ONEThe Loyal Pen PalDer treue Brieffreund

How it counts

  • Your chats only. Sessions from cron, subagent, kanban, batch, webhook and tool are machine work. They are not counted as your chats or messages; cron runs and subagents appear on the night crew card, and their tokens count on the token card.
  • Only what you typed. Code blocks, quoted lines, reply quotes, attachment lines and text Hermes injects as a user message (background notices, compaction summaries, delegation results) are skipped. Very long pastes count with their first 4,000 characters.
  • Time window. A chat belongs to the period in which it started. Hours and days use the timezone setting, or the system time of the machine.
  • Tools and skills. Tool calls are counted from the tool results in your chats; a skill counts when skill_view loaded it successfully.
  • Models. Grouped by family (Claude Opus, Claude Sonnet, DeepSeek, GPT, Qwen and so on), one vote per chat.
  • Tokens. Input plus output as stored by Hermes, cache reads shown separately. Book comparison: Harry Potter 1 to 7 is about 1.08 million words, roughly 1.4 million tokens.
  • No costs. The cost columns in state.db are estimates that do not add up reliably across providers and subscriptions, so the cards show none.
  • Projects. From the Hermes projects list (projects.db): projects created in the period and how many of them are archived. Without projects it counts the working folders of your chats and how many have been quiet for 30 days.
  • Word of the year. The word you used in the most messages (each message counts once), at least four letters, without filler words in English, German, Spanish and French, links, paths, politeness and swear words. Add your own exclusions with exclude_words.
  • Manners. Same word lists and ranks as the manners-meter plugin, built in, so no second plugin is needed.

Settings

Set with hermes config set plugins.entries.year-wrapped.settings.<key> <value> or in the Desktop plugin settings.

KeyDefaultWhat it does
languageautoauto, en or de. Auto picks the language you are polite in most
timezoneemptyIANA name like Europe/Berlin. Empty = system time of this machine
show_titlesfalseShow session titles on cards (same as --show-titles)
exclude_words[]Words never shown as word of the year, for example client names
rename_words[]Entries like acme=Northstar: the word of the year shows the code name instead (counts merge)
excluded_sources[cron, subagent, kanban, batch, webhook, tool]Sources that are not you
browser_pathemptyChrome or Chromium for PNG. Empty = search for Chrome, Chromium, Edge, Brave or a Playwright headless shell

Data and privacy

  • Reads state.db (and projects.db if present) of the active profile read only (mode=ro). Never writes to them.
  • Writes only the cards, by default under <HERMES_HOME>/plugin-data/year-wrapped/. Before writing, old cards of the same period in that folder are replaced. With --out nothing else in the folder is touched.
  • No network, no model calls, no telemetry. The cards load no fonts, scripts or images from anywhere.
  • Session titles are hidden by default. They often name clients or projects. --show-titles shows one title, on the marathon card.
  • Check the word of the year before you post. It is a word you typed, and that can be a client or project name. Exclude such words with exclude_words, or show them under a code name with rename_words / --rename. The preview above uses this for one client name.
  • PNG export starts a local headless browser with the card file and nothing else. Snap packages of Chromium cannot read hidden folders such as ~/.hermes; they are tried last. Set browser_path or use --out with a normal folder if PNG export fails.

Tested

  • 41 offline tests (filters, time windows, timezones, persona axes, tools, skills, projects, word of the year, singular and plural, escaping, read only access, index use, empty and old database schemas, CLI, slash command).
  • hermes plugins validate --json: no warnings.
  • Live in an isolated Hermes home (Hermes Agent v0.23.0, Claude Haiku 4.5 over OpenRouter): plugin installed from a local Git checkout of this folder, three real chat turns, then hermes year-wrapped and /year-wrapped through the real plugin manager against that new history; 10 cards written, 10 PNG rendered.
  • One real history (1.7 GB state.db, about 7,600 typed messages, 11,700 cron sessions): numbers in about 2 seconds with a warm disk cache (about 20 seconds on a cold first read), 13 PNG cards in about 9 seconds more.
  • Not tested yet: macOS and Windows (browser search covers the usual install paths), and /year-wrapped on Telegram, Discord and Desktop (same code path, not seen live).

License

MIT. See LICENSE.

README from the reviewed commit 2d171da; it updates when the author re-pins.

More by MadeByBrain

6 plugins by MadeByBrain in the catalog.

MadeByBrainchat-lengthTells the user when a chat is getting too long and hands them a short opener for a fresh chat; the new chat pulls the earlier context itself via session_search, no handover document. Fill level from real provider token counts, measured against Hermes' compaction point by default; notices at 70 % and 90 % (configurable), once each per chat, re-armed after compaction, never in cron, subagent, kanban, batch or webhook runs. Notice in the conversation language, English or German. Disclosure — on the turn that crosses a threshold, pre_llm_call adds a one-turn instruction to that turn's user message (never the system prompt; replayed byte-identical, so prompt caching stays intact); post_api_request stores per-session token counts, model and provider name and which notice fired (no message content) under HERMES_HOME/plugin-data/chat-length/, pruned after 30 days; reads the session title read-only from state.db and the compression settings read-only from config.yaml; no network calls, no tools, no dependencies.Communitytools1MadeByBrainde-lawGerman federal law, EU law and German federal court decisions for Hermes Agent: read one section or article (§ 203 StGB, Art. 6 DSGVO, Art. 50 AI Act) in the source wording with version status (Stand), gazette reference and a ready source line, search the index of federal laws, list a law's sections, and find and read published decisions of BVerfG, BGH, BVerwG, BFH, BAG, BSG and BPatG. Legal texts, not legal advice. Disclosure: sends HTTPS GET requests only to www.gesetze-im-internet.de (law folder names, the daily index, weekly abbreviation lists), www.rechtsprechung-im-internet.de (the daily index, document ids of decisions you read) and publications.europa.eu (CELEX numbers, text language, one SPARQL query per act listing its consolidated versions); section numbers and search words are not sent, because whole laws are downloaded and searched locally. Public sources, no key. Writes public legal texts and indexes (JSON with ETag, Last-Modified and fetch time; no questions, no session data) under HERMES_HOME/plugin-data/de-law/cache, capped by the cache_max_mb setting (default 200 MB). Reads only its own plugin settings. At most one request per second per host, 25 s timeout, 40 MB response cap. rechtsprechung-im-internet.de sends a tdm-reservation header; the plugin fetches its index and single decisions on request only, and case_law: false turns that source off. No hooks, no cron jobs, no background processes. Tools stay on every platform, including gateways (a guest can call them; hermes tools disables one). While the plugin is enabled, its skill adds one line to the skills index of every session.Communitytools1MadeByBrainmanners-meterHow polite are you to your agent? Counts please, thank you, bitte, danke, por favor, merci and friends in the messages you typed (code blocks, quotes and injected system blocks skipped; cron, subagent, kanban, batch, webhook and tool sessions ignored), estimates the tokens your politeness cost (typed and re-sent with later calls of the same chat, an upper bound, not a bill), keeps a swear jar with a price per coin and gives a silly rank. /manners on every surface and hermes manners in the terminal, plus a share card (self-contained HTML, 1080x1920, no external assets). Disclosure: no network calls, no model calls, standard library only. Reads state.db of the active profile read only (mode=ro). Writes only the share card, by default to HERMES_HOME/plugin-data/manners-meter/manners-card.html. A pre_llm_call hook (jar_reactions, on by default) checks your new message for swear words; when it finds one it adds a short note with the matched word and the jar count to that user message (never to the system prompt) so the agent may answer with one dry line; jar_reactions: false turns it off. Session titles and message texts never appear in the output. No credentials, no shell commands, no cron jobs, no background processes, no telemetry.Communitygeneral1MadeByBrainprivacy-xrayWhere does your data actually go? Records every outgoing model request, the main loop and side tasks such as title generation, compression and vision, as metadata only: destination host, vendor, vendor HQ country, the model vendor behind aggregators such as OpenRouter (read from the model id; the final processing vendor behind an aggregator is not visible), size and counts of detected personal data types (e-mail, IBAN, payment card, phone, IPv4, German Steuer-ID and USt-IdNr, own watch terms). /xray canary invents a fictitious person and /xray trace shows every request and local store that carried it. /xray check audits the config with a severity and the exact hermes config set fix per path; /xray fix <id> --yes applies one; a session retention hint is advice only and is never applied. /xray fix --yes and /xray find run only on local surfaces (CLI, TUI, desktop, dashboard) unless allow_sensitive_on_gateways is turned on. /xray find searches the local stores for a person, /xray report writes a self-contained HTML leak map (no scripts, no external assets) with a before and after view of two canaries; a dashboard tab shows the same page in a sandboxed frame. Not legal advice and not a compliance certificate. Disclosure: no network calls, no model calls, standard library only. pre_api_request and pre_auxiliary_call are observers; they write one metadata line per request (time, session and turn id, task, provider, model, host, vendor, counts, canary id and message fields; never message text or matched values) to HERMES_HOME/plugin-data/privacy-xray/ledger.jsonl (rotated once at ledger_max_mb, default 5 MB). The llm_request middleware is off by default (guard: false); when turned on it masks canary values and watch terms in main model requests before they are sent. Reads the merged Hermes config through load_config_readonly. /xray trace, /xray find and /xray check read outside the plugin's own data, read-only and under a time budget (scan_seconds, default 30): state.db (messages, session titles, stored system prompts, delivery queue), session files including request dumps, memories, logs, cron output, other plugins' plugin-data, paste and pending folders; output shows counts and masked snippets only. Writes config only on /xray fix <id> --yes, through hermes_cli.config.set_config_value (same code as hermes config set); never deletes files. Stores fake canary persons, last check and trace results and requested HTML or Markdown/JSON reports under its plugin-data folder. Registers the tool privacy_xray (map, check, trace, find; read-only, never changes settings), the slash command /xray and a skill that adds one line to the skills index of every session while the plugin is enabled. No credentials, no shell commands, no cron jobs, no background processes, no telemetry.Communitytools1

Developer Mode

Explore built-in Hermes toolsets and actions.

HermesAgent

Developer?

Create a Hermes extension for Desktop or agent workflows.

Developer Section