claude-chronicle

claude-chronicle

Bring Codex Chronicle's screen-recording memory into Claude Code. Ask Claude "what was I doing 5 hours ago?" or "when did I last touch the auth bug?" and get a real answer.

Codex Chronicle passively records your screen, runs OCR, and writes a markdown summary every ~10 minutes describing what you have been doing across your apps. claude-chronicle is a Claude Code plugin that pipes those summaries into Claude Code as context, so Claude knows what you have been working on outside the terminal — past activity, current focus, and the live screen.

What it does

Two hooks, one script:

• SessionStart — when Claude Code starts, injects:
  1. The 3 most recent 10-minute Chronicle summaries as full content (current focus).
  2. A manifest of every Chronicle entry on disk — timestamps, relative ages, absolute paths — so Claude knows the full memory window and can Read any older entry on demand.
  3. A Chronicle live state section — pidfile health, freshest screen frames per display, OCR sidecar locations, and a usage guide that tells Claude which source to reach for given the kind of question.
• UserPromptSubmit — on every prompt, checks for new Chronicle entries that appeared since the last injection and adds only those. Stays silent if there is nothing new.

Both events skip the ## Recording summary and ## Citations sections of each Chronicle file (raw OCR detail and frame paths). Claude sees the ## Memory summary, ### Context of everything that came before this recording, and ### Important non-obvious context about the user sections.

Asking about earlier activity

Because the SessionStart manifest lists every Chronicle file with its local timestamp and "Xh ago" tag, you can ask about anything in that window and Claude will pick the right file(s) and read them:

English	Polski
"What was I doing 5 hours ago?"	"Co robiłem 5 godzin temu?"
"What was I working on yesterday evening?"	"Nad czym pracowałem wczoraj wieczorem?"
"What project was I on the day before yesterday around noon?"	"Przedwczoraj nad południem nad jakim projektem siedziałem?"
"Summarize my whole week."	"Podsumuj mi cały tydzień."

No regex / NLU in the hook — Claude does the time reasoning over the manifest table itself, then uses the Read tool to pull only the entries it actually needs.

/claude-chronicle:remind — on-demand recall

For a force-fresh search of the Chronicle archive (e.g. when the SessionStart manifest has been compacted out of context), invoke the bundled skill. It supports three auto-detected modes:

1. By time — you remember when, not what:

/claude-chronicle:remind 5 hours ago
/claude-chronicle:remind wczoraj wieczorem
/claude-chronicle:remind Tuesday afternoon
/claude-chronicle:remind 30 minut temu

2. By topic — you remember what, not when:

/claude-chronicle:remind the auth bug
/claude-chronicle:remind React 418 error
/claude-chronicle:remind projekt logo w Figmie
/claude-chronicle:remind ta migracja SQL z poniedziałku

The skill rg-greps the whole Chronicle archive for your keyword(s), reports when you last touched the topic, and summarises what you were doing then.

3. Hybrid — both signals at once:

/claude-chronicle:remind the auth bug yesterday
/claude-chronicle:remind Figma logo last week
/claude-chronicle:remind ten error 418 wczoraj wieczorem

The skill narrows by time first, then keyword-greps inside that window.

In all three modes the skill runs autonomously (no "do you want me to read X?" prompts), reads only the picked entries, skips the noisy Recording summary / Citations sections, and answers in your language (PL → PL, EN → EN), naming the source filename(s) so you can verify.

Looking at the screen

The live state section also exposes the ephemeral screen-recording side of Chronicle:

• Live frames (*-display-N-latest.jpg) per display, refreshed by the recorder. Useful for "what's on my screen right now?".
• OCR sidecars (*.ocr.jsonl) — append-only OCR text history. Useful for rg-style searches like "where did I see this error?".
• 1-minute historical frames (1min/<segment>/frame-*.jpg).

The injected guidance teaches Claude to (a) prefer authoritative sources (connectors, file system) over OCR'd screen text, (b) copy latest.jpg to a temp file before manipulating it (the recorder silently overwrites the original), and (c) use OCR only for keyword search, not for verbatim text extraction.