Documentation 2026-06-03 19:27 UTC to 2026-06-04 01:09 UTC

2 2 

3Automate recurring tasks in the background. Codex adds findings to the inbox, or automatically archives the task if there’s nothing to report. You can combine automations with [skills](https://developers.openai.com/codex/skills) for more complex tasks.3Automate recurring tasks in the background. Codex adds findings to the inbox, or automatically archives the task if there’s nothing to report. You can combine automations with [skills](https://developers.openai.com/codex/skills) for more complex tasks.

4 4 

5For project-scoped automations, the app needs to be running, and the selected5For project-scoped automations, the machine running the local Codex app must be

6project needs to be available on disk.6powered on, Codex must be running, and the selected project must still be

7available on disk when the automation is scheduled to run.

7 8 

8In Git repositories, you can choose whether an automation runs in your local9In Git repositories, you can choose whether an automation runs in your local

9project or on a new [worktree](https://developers.openai.com/codex/app/worktrees). Both options run in the10project or on a new [worktree](https://developers.openai.com/codex/app/worktrees). Both options run in the

6 6 

7## General7## General

8 8 

9Choose where files open and how much command output appears in threads. You can also9Choose where files open, how much command output appears in threads, and where

10require `Cmd`+`Enter` for multiline prompts or prevent sleep while a10terminal tabs open by default. You can also require `Cmd`+`Enter`

11thread runs.11for multiline prompts or prevent sleep while a thread runs.

12 12 

13## Profile13## Profile

14 14 

250 250 

251### Configure IP addresses251### Configure IP addresses

252 252 

253If your GitHub organization controls the IP addresses that apps use to connect, make sure to include these [egress IP ranges](https://openai.com/chatgpt-agents.json).253If your GitHub organization controls the IP addresses that apps use to connect, make sure to include the [Codex cloud egress IP ranges](https://developers.openai.com/api/docs/guides/ip-addresses).

254 254 

255These IP ranges can change. Consider checking them automatically and updating your allow list based on the latest values.255These IP ranges can change. Consider checking them automatically and updating your allow list based on the latest values.

256 256 

1951. Open **Plugins** in the Codex app.1951. Open **Plugins** in the Codex app.

1962. Go to **Created by you** and open the plugin details page.1962. Go to **Created by you** and open the plugin details page.

1973. Select **Share**.1973. Select **Share**.

1984. Add workspace members or copy a share link.1984. Add workspace members or workspace groups, or copy a share link.

1995. Choose who has access, then send the invitation or link.1995. Choose who has access, then send the invitation or link.

200 200 

201People you share with can find the plugin under **Shared with you** in the201People you share with can find the plugin under **Shared with you** in the

202plugin directory. Sharing a local plugin with your workspace doesn’t publish202plugin directory. Sharing a local plugin with your workspace doesn’t publish

203it to the public Plugin Directory. Shared plugins stay within your workspace203it to the public Plugin Directory. Shared plugins stay within your workspace

204and organization boundary; accounts that aren’t signed in to that workspace204and organization boundary; accounts that aren’t signed in to that workspace

205can’t access them. Use a marketplace when you want repo or CLI distribution,205can’t access them. Use groups when a team or role should share the same plugin

206and use workspace sharing when you want selected teammates to install a plugin206access. Use a marketplace when you want repo or CLI distribution, and use

207from the Codex app.207workspace sharing when you want selected teammates to install a plugin from the

208Codex app.

208 209 

209Workspace admins can disable plugin sharing from cloud-managed requirements by210Workspace admins can disable plugin sharing from cloud-managed requirements by

210adding `plugin_sharing = false` to `requirements.toml`:211adding `plugin_sharing = false` to `requirements.toml`: