Skip to content

NathanZane/codex-updates

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Updates

Updates is a Codex plugin that sends short progress emails during long-running Codex work.

It currently uses Gmail only. When requested, Codex sends updates to the authenticated Gmail account itself and does not read, search, archive, delete, label, forward, or inspect existing email.

Install From Codex

In Codex, open Plugins, click the add button, and choose Add marketplace.

Add marketplace menu

Use these fields:

Source: NathanZane/codex-updates
Git ref: main
Sparse paths:
.agents/plugins/marketplace.json
plugins/updates

Add marketplace fields

Then install the Updates plugin from the added marketplace.

Install Updates plugin

Setup

Connect Gmail in Codex before using the plugin.

After installing, restart Codex or start a fresh thread so the $updates skill is loaded.

Test

Ask Codex:

Use $updates. Send a test progress update for this thread.

Usage

Tell Codex to use $updates when starting long-running work.

Use $updates during this goal.

By default, Codex sends important updates when useful and avoids sending routine updates more often than every 30 minutes. The skill also tells Codex to keep track of the task start time and last update time while working.

You can also specify different behavior:

Use $updates every 15 minutes.
Use $updates whenever you improve performance by 1%.
Use $updates when you're done with the refactor of the `utils` folder.
Use $updates whenever you've resolved a finding.

Timing requests are approximate. This plugin currently uses a Codex skill, not an enforced background timer, so Codex checks whether to send an update when it regains control after substantial steps or tool calls.

Expected email format:

  • Subject: Codex update: <exact project name>
  • Body: short plain text with Status, Thread, and Next
  • Recipient: the authenticated Gmail account

Example update emails:

Example progress email for a refactor task

Example progress email for a performance task

About

Codex plugin that sends short progress emails during long-running Codex work.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors