timestamps

timestamps is a command for coding agents from AraneaDev/claude-timestamp. It costs 16 tokens per session (5,040 once invoked), scanned A, original, MIT.

A command for configuring the claude-timestamp add-on, which adds local times and turn-duration information to Claude Code messages. It supports settings such as timezone, clock format, colour, and elapsed time.

In plain words
What is it for?
Use it to set the timezone, time display, colours, and duration tracking for claude-timestamp.
Why use it?
It provides one place to change how timing information is shown, without needing to know the configuration file structure.

Command

Installs and runs on its own, but its text points at files inside its plugin — anything it tells you to read at a ${CLAUDE_PLUGIN_ROOT} path is only there once the plugin is installed. Installing the plugin gets both.

Part of the claude-timestamp plugin — 1 command, 8 hooks shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add commands/araneadev/claude-timestamp/timestamps
Clone the repo
git clone --depth 1 https://github.com/AraneaDev/claude-timestamp

Or install claude-timestamp, the plugin that ships this one along with the rest of its 1 command, 8 hooks.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for timestamps

README.md
[![agentmods](https://agentmods.dev/badge/commands/araneadev/claude-timestamp/timestamps.svg)](https://agentmods.dev/commands/araneadev/claude-timestamp/timestamps)
Your own site
<a href="https://agentmods.dev/commands/araneadev/claude-timestamp/timestamps"><img src="https://agentmods.dev/badge/commands/araneadev/claude-timestamp/timestamps.svg" alt="Measured on agentmods" height="20"></a>
Per session 16 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 5,040 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00016 $0.05040
Opus 5 $0.00008 $0.02520
Sonnet 5 $0.00003 $0.01008
Haiku 4.5 $0.00002 $0.00504

Measured today against content hash 3b35e71da051, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-05, from the pricing page.

Security

Grade A, and why

timestamps scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

commands/timestamps.md · 407 lines

How it starts

The opening of the file, as written. The whole thing — 407 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Configure the claude-timestamp plugin for this user.

Settings take effect on the next message. Every hook reads the config file each time it runs, so nothing needs restarting. Say so when you report back, because people reasonably assume otherwise.

Do all of this by reading and editing files, with Read, Edit and Write. Do not use the Bash tool for any of it: not to read the settings, not to work out the time, not to check whether a program is installed, not to apply a change. There is a terminal wizard, and the last section says how to reach it, but driving it from here is slower, noisier, and needs a Bash permission the user does not otherwise have to grant.

What the user asked for

$ARGUMENTS

What to read first

  1. ${CLAUDE_PLUGIN_ROOT}/schema.json is the contract. Its keys object holds every setting, its default, its acceptable values and what it does. Its presets object holds a handful of whole configurations, each one naming the exact set of keys it writes. Treat it as the only source of truth about what a key may hold.

  2. ~/.claude/claude-timestamp.facts.json holds what you cannot work out by reading files: whether this machine has a timezone database, whether the state directory is writable, whether jq is present, and which plugin version is installed.

    Facts are grouped under clients, keyed by the Claude Code client that wrote them. Any client name Claude Code reports is kept as its own key, so cli, claude-vscode and claude-desktop are examples rather than the whole list, and sdk-cli or a name newer than this file would each appear under themselves. unknown covers a Claude Code too old to name itself, and anything whose name is not plain letters, digits, dashes or underscores. One home directory can serve several clients at once, so read the entry for the client you are being asked about, not whichever one happens to be first. Each entry carries a written_at in seconds since the epoch; compare it against date +%s to see whether it describes this session or one from weeks ago.

Read the full file on GitHub · 407 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. today Changed · +32 lines 3b35e71da051
  2. 5d ago First seen · 375 lines · 16 tokens per session scan A 148ce9848e7d

Subscribe to this mod's changes

timestamps is a command published in the GitHub repository AraneaDev/claude-timestamp (3 stars, last pushed yesterday), licensed MIT. It adds 16 tokens to every session and 5,040 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.