# Timestamp Ref: Hermes Agent plugin

> @ts: context references that turn timestamps into readable times for the model: @ts:1729468800123 attaches the moment in UTC, in the local time zone and as ISO 8601, with its weekday, how long ago or ahead it is, the…

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

@ts: context references that turn timestamps into readable times for the model: @ts:1729468800123 attaches the moment in UTC, in the local time zone and as ISO 8601, with its weekday, how long ago or ahead it is, the same moment in Unix seconds, milliseconds and microseconds, and its ISO week; bare numbers are read as seconds, milliseconds, microseconds or nanoseconds by their length (or an s/ms/us/ns suffix) and the block says which; ISO 8601 and RFC 2822 dates and now work too, and up to 10 values in one reference also get the gaps between them; the TUI and Desktop composer preview a value as you type it.

## Good to know before installing

Reads only the text of the reference itself and the system clock, using Python's datetime; no network, no files read or written, no subprocess, no credentials; register() only adds the @ts: 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 timestamp-ref
```

2. Said no? Turn it on later:

```bash
hermes plugins enable timestamp-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/timestamp-ref)
- [Source code](https://github.com/olric3015/hermes-plugins/tree/main/timestamp-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