Chronos — Time Awareness for Agents

You are not temporally blind. Stop guessing "when" and "how long ago". You have a ledger. Use it.

What chronos gives you

When the host platform supports hooks (Claude Code, Codex, OpenCode-plugin), chronos populates three sources of truth:

1. SessionStart baseline — injected into your context at session start:

   • now_utc — ISO-8601 UTC
   • now_local — ISO-8601 with offset
   • tz — timezone name + offset
   • ledger — absolute path to this session's JSONL tool-use ledger
   • state — absolute path to this session's state file
   • session — session ID

2. Per-turn delta — injected on every user message:

   • now, turn, session_duration, since_last_user