# chronos

> Claude/Codex skill by [@OthmanAdi](https://omgskills.com/library/othmanadi/index.md) · 2 stars · Updated 2026-05-25

Gives AI coding agents temporal awareness via a hook-backed ledger and decision rules. Activates whenever an agent reasons about recency, retry windows, memory staleness, deploy cooldowns, idle detection, or any "when / how long ago" question. Required for autonomous or long-running agents.

Tags: time, temporal, autonomy, ledger, agents, hooks, session-management, agent-skills, ai-agents, autonomous-agents, claude-code, codex, llm, temporal-awareness

## Install

```sh
git clone https://github.com/OthmanAdi/chronos ~/.claude/skills/chronos
```

## From README

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: SessionStart baseline — injected into your context at session start: nowutc — ISO-8601 UTC nowlocal — 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 Per-turn delta — injected on every user message: now, turn, sessionduration, sincelastuser Tool-use ledger — JSONL file, one entry per tool invocation: {tooluseid, tool, argshash, startedat, finishedat, durationms, success} If the host platform does not support hooks (Cursor, Hermes, ADAL, plain skill-only mode), chronos degrades: run date -u or date -Iseconds at decision points and state explicitly "derived from shell, not ledger".

## Links

- HTML page: https://omgskills.com/skills/othmanadi/chronos/
- GitHub: https://github.com/OthmanAdi/chronos
- Author: [@OthmanAdi](https://omgskills.com/library/othmanadi/index.md)

## More skills by this author

- [planning-with-files](https://omgskills.com/skills/othmanadi/planning-with-files/planning-with-files/index.md) — Persistent file-based planning for multi-step AI-agent work.
   - [@othmanadi](https://omgskills.com/library/othmanadi/index.md) · 27k stars
- [planning-with-files-ar](https://omgskills.com/skills/othmanadi/planning-with-files/planning-with-files-ar/index.md) — تخطيط مستمر قائم على الملفات لعمل وكلاء الذكاء الاصطناعي متعدد الخطوات.
   - [@othmanadi](https://omgskills.com/library/othmanadi/index.md) · 26k stars
- [planning-with-files-de](https://omgskills.com/skills/othmanadi/planning-with-files/planning-with-files-de/index.md) — Persistente dateibasierte Planung für mehrstufige Arbeit mit KI-Agenten.
   - [@othmanadi](https://omgskills.com/library/othmanadi/index.md) · 26k stars