# Jwt Ref: Hermes Agent plugin

> @jwt: context references that decode a JSON Web Token for the model: @jwt:<token> (or a quoted "Bearer <token>") attaches the header with the algorithm in words, every claim as JSON, the exp, nbf, iat and auth_time…

Canonical: https://hermeswatcher.com/plugins/jwt-ref  
Tier: Community  
Official page (Nous Research): https://hermes-agent.nousresearch.com/docs/plugins/jwt-ref  
Last updated in catalog: 2026-10-23

@jwt: context references that decode a JSON Web Token for the model: @jwt:<token> (or a quoted "Bearer <token>") attaches the header with the algorithm in words, every claim as JSON, the exp, nbf, iat and auth_time claims in UTC with how long ago or ahead they are, whether the token has expired and its lifetime, and notes on alg none, a missing or empty signature, a header that names its own key (jku, x5u, jwk), crit and duplicate names; encrypted tokens (JWE) show their header only; the TUI and Desktop composer preview a token as you type it. The signature is never verified.

## Good to know before installing

Reads only the text of the reference itself and the system clock, using Python's base64, json and datetime; no network (no key sets fetched), no files read or written, no subprocess, no credentials read; the plugin keeps no copy of the token, but the @jwt: reference and the decoded header and claims become part of the message sent to your model provider and saved in the session history, so decode only tokens you are willing to share with it; register() only adds the @jwt: reference provider.

From the plugin's catalog listing.

## How to install

1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.

```bash
hermes plugins install jwt-ref
```

2. Said no? Turn it on later:

```bash
hermes plugins enable jwt-ref
```

3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see the official page. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide: https://hermes-agent.nousresearch.com/docs/user-guide/features/plugins

## Facts

- Category: Cost, speed & monitoring
- Maintained by: olric3015 (Community)
- Needs: No API keys declared
- Requires Hermes: `>=0.21.5`
- Version: 1.0.0
- In the catalog since: 2026-10-23

## Links

- [Full setup and settings (official page)](https://hermes-agent.nousresearch.com/docs/plugins/jwt-ref)
- [Source code](https://github.com/olric3015/hermes-plugins/tree/main/jwt-ref)
- [All plugins](https://hermeswatcher.com/plugins.md)

---

HermesWatcher is an independent guide. It is not affiliated with or endorsed by Nous Research. The [official Hermes Agent documentation](https://hermes-agent.nousresearch.com/docs) and [repository](https://github.com/NousResearch/hermes-agent) from Nous Research are the authority; each page here lists the official sources it was written from. If this site and the official docs disagree, trust the official docs. Index for agents: https://hermeswatcher.com/llms.txt