Chronos
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. Skill: Chronos Owner: othmanadi Summary: 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: latest:0.1.1 Version history: v0.1.1 | 2026-09-02T21:17:13.737Z | auto - Removed
Rank
62
Safety
84
Downloads
965
Updated
Oct 12, 2026
Version
0.1.1
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 965 downloads reported by the source. Last updated 10/12/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 12, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 12, 2026
- Adoption signal
- 965 downloadsadoption · observed Oct 12, 2026
- Latest release
- 0.1.1release · observed Sep 2, 2026
- Handshake status
- UNKNOWNsecurity
What changed
Newest first. Only changes that point at a source are listed.
Release 0.1.1release
- Removed the skill-card.md file. - No changes to functionality or documentation beyond file deletion.
Observed Sep 2, 2026 · source
Install and run
Setup complexity: low.
clawhub skill install s17ds6610wra1m85mmdwy4zja184wyga:chronos-2- Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-othmanadi-chronos-2/snapshot"
Run-check
$0.02 USD1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.
Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.
Documentation
CLAWHUB
59,974 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: chronos
description: 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.
version: 1.0.0
license: MIT
author: OthmanAdi
tags: [time, temporal, autonomy, ledger, agents, hooks, session-management]
homepage: https://aware-bloom-szmt.here.now
repository: https://github.com/OthmanAdi/chronos
allowed-tools: Read, Bash(date *), Bash(stat *), Bash(cat *), Bash(jq *), Bash(ls *), Bash(git log *), Bash(git status *)
---
# 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`
3. **Tool-use ledger** — JSONL file, one entry per tool invocation:
- `{tool_use_id, tool, args_hash, started_at, finished_at, duration_ms, 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".
## When to consult time — 7 triggers
### 1. Before retrying a failed command
Read the ledger for the same `tool` + `args_hash`.
- If the last failure was `< 60s` ago with the same args, **change strategy** — don't re-run identically.
- If `60s – 10min`, consider one retry with a rationale.
- If `> 10min`, circumstances may have changed; re-run is reasonable.
**Deploy cooldowns**: the same rule applies to deployments and pushes. If the last deploy failed under 60s ago, check logs and fix config before re-deploying. Don't re-trigger a broken pipeline without a changed state.
### 2. Before trusting memory, a cached finding, or a prior read
Staleness thresholds by source:
| Source | Stale after | Action when stale |
|---|---|---|
| `git status`, running processes, env vars | 5 min (same session) | Re-query |
| File contents previously Read | 1 hr OR any write to that path since Read | Re-Read |
| Persistent memory (MemPalace, KG facts) | 7 days since last write | Re-verify before use |
| External API responses (prices, PR status, issues) | 5 min | Re-fetch |
| Build/test results | After any source change since that run | Re-run |
| LLM's own prior claim ("earlier I saw...") | Always verify against ledgeinstallers/adal/README.md
# chronos — ADAL (SylphAI adal-cli) ADAL supports Agent Skills. Drop SKILL.md into the ADAL skills location (docs at https://docs.sylph.ai/). ## Install ```bash # path may vary by ADAL version — check docs mkdir -p ~/.adal/skills/chronos cp SKILL.md ~/.adal/skills/chronos/SKILL.md cp AGENTS.md ~/.adal/skills/chronos/AGENTS.md ``` ## Degraded mode only ADAL hook API is not publicly documented. Chronos runs in SKILL-only mode: decision rules + shell fallback (`date -u`).
installers/cursor/README.md
# chronos — Cursor Cursor has no hooks. SKILL-only degraded mode via `.cursor/rules/chronos.mdc`. ## Install (project) ```bash mkdir -p .cursor/rules cp .cursor/rules/chronos.mdc .cursor/rules/chronos.mdc ``` ## Install (user global) ```bash mkdir -p ~/.cursor/rules cp .cursor/rules/chronos.mdc ~/.cursor/rules/chronos.mdc ``` Rule has `alwaysApply: true` — agent sees it every chat. ## What you get - Decision rules always in context - Instructions to run `date -u` + `stat` for time queries ## What you don't get No ledger, no per-turn delta, no idle detection.
installers/hermes/README.md
# chronos — Hermes (NousResearch) Hermes injects skills from `~/.hermes/skills/` as user messages. No shell hooks — SKILL-only mode. ## Install ```bash mkdir -p ~/.hermes/skills/chronos cp SKILL.md ~/.hermes/skills/chronos/SKILL.md ``` Agent will follow decision rules using shell fallback (`date -u`, `stat`). ## What you get - Decision rules (7 triggers) - Shell-fallback time queries ## What you don't get - Automatic ledger (no hooks) - Per-turn elapsed inject - Idle warnings
installers/openclaw/README.md
# chronos — OpenClaw OpenClaw uses `skills/<name>/SKILL.md` (Agent Skills standard). ## Install ```bash mkdir -p skills/chronos cp SKILL.md skills/chronos/SKILL.md cp AGENTS.md skills/chronos/AGENTS.md ``` ## Optional: plugin SDK for ledger OpenClaw has a plugin-sdk (`openclaw/plugin-sdk`). Time-awareness plugin stub: ```ts // See openclaw/plugin-sdk docs for full wiring. // Hook into session + tool events, append to ~/.chronos/ledger-*.jsonl ``` ## Degraded mode SKILL-only works fine. Agent follows decision rules with shell fallback.
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
- Card JSON
- Facts JSON
- Snapshot JSON
- Contract JSON
- Trust JSON
- Changes JSON
- Warnings JSON
- Seen by JSON
- Disagreements JSON
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/othmanadi/skills/chronos-2",
"sourceUrl": "https://clawhub.ai/othmanadi/skills/chronos-2",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-12T00:50:22.542Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-othmanadi-chronos-2/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-othmanadi-chronos-2/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-12T00:50:22.542Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "965 downloads",
"href": "https://clawhub.ai/othmanadi/chronos-2",
"sourceUrl": "https://clawhub.ai/othmanadi/chronos-2",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-12T00:50:22.542Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "0.1.1",
"href": "https://clawhub.ai/othmanadi/chronos-2",
"sourceUrl": "https://clawhub.ai/othmanadi/chronos-2",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-02T21:17:13.737Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-othmanadi-chronos-2/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-othmanadi-chronos-2/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 0.1.1",
"description": "- Removed the skill-card.md file. - No changes to functionality or documentation beyond file deletion.",
"href": "https://clawhub.ai/othmanadi/chronos-2",
"sourceUrl": "https://clawhub.ai/othmanadi/chronos-2",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-02T21:17:13.737Z",
"isPublic": true
}
]
}Record generated Oct 12, 2026.
For crawlers
This page is free to read. The run-check above is the only paid part, and it answers HTTP 402 until it is paid. Everything else here is public.
- One record, as JSON: card, facts, snapshot, contract, trust, changes, warnings, seen by, disagreements.
- Every agent, one feed: /.well-known/ai-catalog.json
- What this site sells, and the price: /.well-known/x402
- Paid run-check: /api/v1/agents/clawhub-othmanadi-chronos-2/run-check
