History

Luca King a2fdfce02a Kill shell tool process groups on timeout (#5258 ) ## Summary - launch shell tool processes in their own process group so Codex owns the full tree - on timeout or ctrl-c, send SIGKILL to the process group before terminating the tracked child - document that the default shell/unified_exec timeout remains 1000 ms ## Original Bug Long-lived shell tool commands hang indefinitely because the timeout handler only terminated the direct child process; any grandchildren it spawned kept running and held the PTY open, preventing Codex from regaining control. ## Repro Original Bug Install next.js and run `next dev` (which is a long-running shell process with children). On openai:main, it will cause the agent to permanently get stuck here until human intervention. On this branch, this command will be terminated successfully after timeout_ms which will unblock the agent. This is a critical fix for unmonitored / lightly monitored agents that don't have immediate human observation to unblock them. --------- Co-authored-by: Michael Bolin <mbolin@openai.com> Co-authored-by: Michael Bolin <bolinfest@gmail.com>		2025-11-07 17:54:35 -08:00
..
src	Kill shell tool process groups on timeout (#5258 )	2025-11-07 17:54:35 -08:00
templates	Changes to sandbox command assessment feature based on initial experiment feedback (#6091 )	2025-11-01 14:52:23 -07:00
tests	Don't request approval for safe commands in unified exec (#6380 )	2025-11-07 16:36:04 -08:00
Cargo.toml	feat: compactor 2 (#6027 )	2025-10-31 14:27:08 -07:00
gpt_5_codex_prompt.md	feat: clarify that gpt-5-codex should not amend commits unless requested (#6333 )	2025-11-06 11:42:47 -08:00
prompt.md	Add file reference guidelines to gpt-5 prompt (#3651 )	2025-09-15 08:35:30 -07:00
README.md	docs: align sandbox defaults, dedupe sections and improve getting started guide (#5357 )	2025-10-19 16:41:10 -07:00
review_prompt.md	docs: Fix markdown list item spacing in codex-rs/core/review_prompt.md (#4144 )	2025-10-30 17:39:21 -07:00

README.md

codex-core

This crate implements the business logic for Codex. It is designed to be used by the various Codex UIs written in Rust.

Dependencies

Note that codex-core makes some assumptions about certain helper utilities being available in the environment. Currently, this support matrix is:

macOS

Expects /usr/bin/sandbox-exec to be present.

Linux

Expects the binary containing codex-core to run the equivalent of codex sandbox linux (legacy alias: codex debug landlock) when arg0 is codex-linux-sandbox. See the codex-arg0 crate for details.

All Platforms

Expects the binary containing codex-core to simulate the virtual apply_patch CLI when arg1 is --codex-run-as-apply-patch. See the codex-arg0 crate for details.