memories/chronicle.md Codex Docs, 2026-05-02 00:48 UTC → 2026-05-18 22:01 UTC

21building, Chronicle can help Codex understand what you’re referring to, identify21building, Chronicle can help Codex understand what you’re referring to, identify

22the right source to use, and pick up on the tools and workflows you rely on.22the right source to use, and pick up on the tools and workflows you rely on.

23 23 

24<section class="feature-grid mt-4">

25 

26<div>

27 

24### Use what’s on screen28### Use what’s on screen

25 29 

26With Chronicle Codex can understand what you are currently looking at, saving30With Chronicle Codex can understand what you are currently looking at, saving

27you time and context switching.31you time and context switching.

28 32 

33</div>

34 

35<ChronicleThreadDemo client:load scenario="screen" />

36 

37</section>

38 

39<section class="feature-grid inverse">

40 

41<div>

42 

29### Fill in missing context43### Fill in missing context

30 44 

31No need to carefully craft your context and start from zero. Chronicle lets45No need to carefully craft your context and start from zero. Chronicle lets

32Codex fill in the gaps in your context.46Codex fill in the gaps in your context.

33 47 

48</div>

49 

50<ChronicleThreadDemo client:load scenario="project" />

51 

52</section>

53 

54<section class="feature-grid">

55 

56<div>

57 

34### Remember tools and workflows58### Remember tools and workflows

35 59 

36No need to explain to Codex which tools to use to perform your work. Codex60No need to explain to Codex which tools to use to perform your work. Codex

37learns as you work to save you time in the long run.61learns as you work to save you time in the long run.

38 62 

63</div>

64 

65<ChronicleThreadDemo client:load scenario="tools" />

66 

67</section>

68 

39In these cases, Codex uses Chronicle to provide additional context. When another69In these cases, Codex uses Chronicle to provide additional context. When another

40source is better for the job, such as reading the specific file, Slack thread,70source is better for the job, such as reading the specific file, Slack thread,

41Google Doc, dashboard, or pull request, Codex uses Chronicle to identify the71Google Doc, dashboard, or pull request, Codex uses Chronicle to identify the

516. When setup completes, choose **Try it out** or start a new thread.816. When setup completes, choose **Try it out** or start a new thread.

52 82 

53If macOS reports that Screen Recording or Accessibility permission is denied,83If macOS reports that Screen Recording or Accessibility permission is denied,

54open System Settings > Privacy & Security > Screen Recording or84open System Settings > Privacy & Security > Screen Recording or

55Accessibility and enable Codex. If a permission is restricted by macOS or your85Accessibility and enable Codex. If a permission is restricted by macOS or your

56organization, Chronicle will start after the restriction is removed and Codex86organization, Chronicle will start after the restriction is removed and Codex

57receives the required permission.87receives the required permission.

61You control when Chronicle generates memories using screen context. Use the91You control when Chronicle generates memories using screen context. Use the

62Codex menu bar icon to choose **Pause Chronicle** or **Resume Chronicle**. Pause92Codex menu bar icon to choose **Pause Chronicle** or **Resume Chronicle**. Pause

63Chronicle before meetings or when viewing sensitive content that you do not want93Chronicle before meetings or when viewing sensitive content that you do not want

64Codex to use as context. To disable Chronicle, return to **Settings >94Codex to use as context. To disable Chronicle, return to **Settings >

65Personalization > Memories** and turn off **Chronicle**.95Personalization > Memories** and turn off **Chronicle**.

66 96 

67You can also control whether memories are used in a given thread. [Learn97You can also control whether memories are used in a given thread. [Learn

68more](https://developers.openai.com/codex/memories#control-memories-per-thread).98more](https://developers.openai.com/codex/memories#control-memories-per-thread).

97computer under `$CODEX_HOME/memories_extensions/chronicle/` (typically127computer under `$CODEX_HOME/memories_extensions/chronicle/` (typically

98`~/.codex/memories_extensions/chronicle`).128`~/.codex/memories_extensions/chronicle`).

99 129 

100Both directories for your screen captures and memories might contain sensitive information. Make sure you do not share content with others, and be aware that other programs on your computer can also access these files.130<div className="not-prose my-4">

131 <Alert

132 client:load

133 color="danger"

134 variant="soft"

135 description="Both directories for your screen captures and memories might contain sensitive information. Make sure you do not share content with others, and be aware that other programs on your computer can also access these files."

136 />

137</div>

101 138 

102### What data gets shared with OpenAI?139### What data gets shared with OpenAI?

103 140 

131 168 

132If you do not see the Chronicle setting, make sure you are using a Codex app169If you do not see the Chronicle setting, make sure you are using a Codex app

133build that includes Chronicle and that you have Memories enabled inside Settings170build that includes Chronicle and that you have Memories enabled inside Settings

134> Personalization.171> Personalization.

135 172 

136Chronicle is currently only available for ChatGPT Pro subscribers on macOS.173Chronicle is currently only available for ChatGPT Pro subscribers on macOS.

137Chronicle is not available in the EU, UK and Switzerland.174Chronicle is not available in the EU, UK and Switzerland.