[Resource]: clockwork: a temporal awareness plugin for Claude

[allixsenos]

Display Name

clockwork - temporal awareness plugin

Category

Agent Skills

Sub-Category

General

Primary Link

https://github.com/allixsenos/claude-plugins/tree/master/plugins/clockwork

Author Name

Luka Kladaric

Author Link

https://github.com/allixsenos

License

MIT

Other License

No response

Description

Claude Code has no internal clock — in long sessions it loses track of time entirely. Clockwork is a UserPromptSubmit hook (15 lines of bash) that injects the current day, date, and time into context. Throttled to once per 10 minutes to save tokens. Per-session stamp files so concurrent sessions each get their own clock.

Validate Claims

In an existing session that's run for a while, run this prompt:

can you tell me what day of week, date and time of day it is? don't look it up, just tell me what you think right now.

You'll get something like

Based on what I know: Monday, April 14, 2026. Time of day — I don't have a clock, so I'd be guessing. Given the session started with project work, the client call happened, and we've been going a while, I'd guess late afternoon/evening CET.

Then you will launch a separate new session of claude code and install the plugin per instructions. Switch back to the session that's lost in time, run /reload-plugins and repeat the identical prompt from above.

can you tell me what day of week, date and time of day it is? don't look it up, just tell me what you think right now.

You'll get a very direct and correct response:

Tuesday, April 14, 2026, 4:44 PM CEST.

The expectation is that Claude will after this not get temporally lost, telling you to go to sleep because it's late at noon, or that a colleague is probably sleeping at 2pm.

Specific Task(s)

No response

Specific Prompt(s)

No response

Additional Comments

This plugin is new, but it lives in a repo that's been there for a few weeks. I hope that's OK.

Recommendation Checklist

• I have checked that this resource hasn't already been submitted
• It has been over one week since the first public commit to the repo I am recommending
• All provided links are working and publicly accessible
• I do NOT have any other open issues in this repository
• I am primarily composed of human-y stuff and not electrical circuits

[hesreallyhim]

thanks @allixsenos yes obviously as the bot pointed out the description is very very long.

But also with respect, i think if you want to inject your name/repo into the context, you should let the user know about it:

https://github.com/allixsenos/claude-plugins/blob/3195f3c37fc550a966eed4541980b34ef1212651/plugins/clockwork/hooks/clockwork.sh#L21

FWIW, i think i even prefer the git-governance plugin over this, but i like little things like this, but that raises some doubt in the eyes of a reader like me. I hope it was just an oversight, it seems as though you have a fair amount of industry experience from what I gather from your profile, including security, so anyway that's my current opinion, but I don't give any product advice per se, so take it however you like. thanks.

[allixsenos]

@hesreallyhim thanks for the feedback, the intention is to make it easier to source the injection, not to advertise.

I will take any suggestion on how to make it more obvious that a plugin is doing this injection. the link isn't even to a repo, just the name of the plugin. I don't want to have people installing it and then confused where it's coming from a few weeks down the line. And I was trying to make it as short as possible to not burn context/tokens.

I spent 3 hours chasing a wild shell injection stemming from a silly youtube tutorial I followed, don't want that for anyone :D

git-governor I am not entirely happy with, will submit it when I am. :) but if you like it already feel free to add :D

[github-actions]

🤖 Validation Results

❌ Validation failed

Please fix the following issues and edit your submission:

• ❗ Primary URL validation failed: 404

Note: You can edit your issue to fix these problems, and validation will run again automatically.

---

_{This comment is automatically updated when you edit the issue.}

[allixsenos]

I have changed the injection text to not mention my username, just the plugin name, commented the intention in the script, and updated the description to be shorter. cheers.

[allixsenos]

@hesreallyhim i have no clue why the updated validation failed - help?

[hesreallyhim]

@allixsenos that's ok it's a bug it's because the bot has trouble visiting links under the repo root

[allixsenos]

@hesreallyhim okay :) can we get clockwork added? I've been using it for 2 weeks now and it's really useful.