zero-dependency time awareness for Claude Code. Injects a throttled [⏱ time] block on user prompt and on compaction. No more "good morning" when it's already 8pm and you are still in the office.

A developer created a zero-dependency Python script that injects a throttled time-awareness block into Claude Code prompts, preventing the AI from greeting users with "good morning" when it is actually 8 PM. The script hooks into both UserPromptSubmit and SessionStart events, tracking session age and local time, and re-injects the time block after conversation compaction. Users configure the tool by pointing two hook events in their Claude settings.json to the temporal.py script.

| /usr/bin/env python3 | | | """ | | | temporal.py — zero-dep time awareness for Claude Code. | | | Injects a throttled ⏱ time block on UserPromptSubmit, and re-injects | | | right after a compaction via SessionStart source=compact . | | | State: ~/.claude/.temporal/<session id .json | | | Env: TEMPORAL INTERVAL=300 min secs between injects, 0=always | | | Wire both UserPromptSubmit and SessionStart in settings.json to: | | | python3 ~/.claude/hooks/temporal.py | | | In ~/.claude/settings.json point these two events at it: | | | {"hooks": { | | | "UserPromptSubmit": {"matcher":"","hooks": {"type":"command","command":"python3 ~/.claude/hooks/temporal.py"} } , | | | "SessionStart": {"matcher":"","hooks": {"type":"command","command":"python3 ~/.claude/hooks/temporal.py"} } | | | }} | | | """ | | | import json, os, sys, time | | | from datetime import datetime, timezone | | | from pathlib import Path | | | INTERVAL S = int os.environ.get "TEMPORAL INTERVAL", 300 | | | TTL S = int os.environ.get "TEMPORAL TTL DAYS", 7 86400 | | | DIR = Path.home / ".claude" / ".temporal" | | | def fmt s : | | | if s < 60: return f"{s}s" | | | if s < 3600: return f"{s // 60}m{s % 60:02d}s" | | | return f"{s // 3600}h{ s % 3600 // 60:02d}m" | | | def emit event, context : | | | Claude Code reads context from this nested hookSpecificOutput shape | | | print json.dumps {"hookSpecificOutput": | | | {"hookEventName": event, "additionalContext": context}} | | | def main : | | | data = json.loads sys.stdin.read .strip or "{}" | | | event = data.get "hook event name", "" | | | DIR.mkdir parents=True, exist ok=True | | | for old in DIR.glob " .json" : sweep stale sessions | | | if time.time - old.stat .st mtime TTL S: | | | old.unlink missing ok=True | | | f = DIR / f"{data.get 'session id', 'nosession' }.json" | | | s = json.loads f.read text if f.exists else {} | | | now ms = int time.time 1000 | | | utc, local = datetime.now timezone.utc , datetime.now .astimezone | | | setdefault stamps start ms on first sight so session age survives restarts | | | session s = now ms - s.setdefault "start ms", now ms // 1000 | | | stamp = f"now={local:%H:%M} {local:%Z} | utc={utc:%Y-%m-%dT%H:%M:%SZ} | " | | | f"unix ms={now ms} | session={fmt session s }" | | | if event == "UserPromptSubmit": | | | only inject once per INTERVAL S window | | | if now ms - s.get "last inject ms", 0 // 1000 = INTERVAL S: | | | s "last inject ms" = now ms | | | emit event, f" ⏱ {stamp} " | | | elif event == "SessionStart" and data.get "source" == "compact": | | | emit event, f" ⏱ post-compaction time check — {stamp} " | | | f.write text json.dumps s | | | if name == " main ": | | | main |