Codex Chronicle Gives Your AI Coder a Memory of Your Work
OpenAI's Chronicle feature captures your screen to give Codex persistent context between sessions. Here's how it works and the privacy trade-offs.
OpenAI shipped 'Chronicle' as an opt-in research preview inside the Codex Mac app on April 21. It continuously captures your screen, extracts text from what it sees, and stores that context locally — so when you start a Codex session, it already knows what you were working on, what errors appeared in your terminal, and which files you had open. The goal is to solve one of the biggest friction points in AI coding: re-explaining context every time you start a new session.
How Chronicle Actually Works
Chronicle runs a background process that takes regular screenshots and sends them to OpenAI's servers for text extraction. The extracted text — code snippets, error messages, file names, terminal output — is stored in a local database on your Mac. When you open Codex and ask a question, Chronicle injects relevant context from its memory automatically. You don't need to paste error messages or explain what you were doing. Codex already knows.
The storage is local and unencrypted. The screenshot processing happens on OpenAI's cloud infrastructure. This two-part architecture means your raw screen images leave your machine, but the extracted text stays on your computer.
Chronicle is opt-in and off by default. Go to Codex → Settings → Chronicle to enable it. You can pause capture at any time and delete stored memories from the same settings panel.
What This Changes in Practice
The practical benefit shows up in these scenarios: you saw an error this morning and closed the terminal — Chronicle can recall the exact message. You had three documentation tabs open — Chronicle knows which APIs you were researching. A bug appeared while testing — Chronicle saw the state of your app before and after the crash. Each of these normally means copying and pasting context by hand.
I was debugging a failing test earlier today. Based on what you saw on my screen, what was the test checking and what error appeared? Can you suggest what the root cause might be? What files have I had open most often this week? Based on the code you've seen, what area of the codebase am I primarily working on right now? The Privacy Trade-offs
Screenshots processed on OpenAI's servers is a real concern for anyone working with proprietary business logic, customer data, unreleased product features, or code covered by an NDA. OpenAI's data processing agreement governs how screenshots are handled, but screenshots leave your machine — that's a straightforward fact. The local unencrypted storage is also worth noting: anyone with access to your Mac can read Chronicle's stored memories.
Don't use Chronicle if your codebase contains customer PII, trade secrets, or code covered by a confidentiality agreement. The convenience isn't worth the data exposure. Chronicle is safest for personal projects and open source work.
How It Compares to Microsoft Recall
Chronicle is OpenAI's answer to Microsoft's controversial Recall feature for Windows, which also captured screen content for AI memory. Recall faced significant backlash and multiple delays over privacy concerns. OpenAI made Chronicle opt-in with clear manual controls — a more cautious rollout — but the fundamental question is the same: do you trust cloud-processed screenshots in exchange for better AI context? The answer depends entirely on what's on your screen.
Key Takeaway
Codex Chronicle captures your screen to give the AI persistent context across sessions — reduces re-explaining, but your screenshots go to OpenAI's servers. Enable it for personal or open source projects; skip it for proprietary codebases.
Frequently Asked Questions
Does Chronicle work with tools other than Codex?
No. Chronicle is built into the Codex Mac app and only provides context to Codex sessions. It doesn't share memories with ChatGPT, the OpenAI API, or any other tool. It's also Mac-only — no Windows version has been announced as of April 2026.
Can OpenAI use my Chronicle screenshots to train future models?
OpenAI's current API data processing agreement allows data use for safety and service improvement, but not for training generative models by default. For Chronicle specifically, check the privacy settings page inside the app — it shows which policies apply to your account type. If your organization has an enterprise OpenAI agreement, your DPA likely includes explicit data protections.
How much disk space does Chronicle use?
OpenAI hasn't published specific storage estimates. Captures processed into text are much smaller than raw images, so local storage impact should be modest for most developers. You can check and manage Chronicle's data from Settings → Chronicle → Manage Storage.
Personalized for your role
Get Your AI Career Action Plan
Our AI Advisor builds you a personalized AI Readiness Score, skills gap analysis, and 30/60/90 day plan based on your specific role and experience.
Try the AI Advisor →Level up your AI coding every week
New tips, tool updates, and workflows every week. Stay ahead of what AI can do for your code.
We respect your privacy. No spam, ever.