History

baumann-oai 1ce722ed2e plan mode: add TL;DR checkpoint and client behavior note (#10195 ) ## Summary - Tightens Plan Mode to encourage exploration-first behavior and more back-and-forth alignment. - Adds a required TL;DR checkpoint before drafting the full plan. - Clarifies client behavior that can cause premature “Implement this plan?” prompts. ## What changed - Require at least one targeted non-mutating exploration pass before the first user question. - Insert a TL;DR checkpoint between Phase 2 (intent) and Phase 3 (implementation). - TL;DR checkpoint guidance: - Label: “Proposed Plan (TL;DR)” - Format: 3–5 bullets using `- ` - Options: exactly one option, “Approve” - `isOther: true`, with explicit guidance that “None of the above” is the edit path in the current UI. - Require the final plan to include a TL;DR consistent with the approved checkpoint. ## Why - In Plan Mode, any normal assistant message at turn completion is treated as plan content by the client. This can trigger premature “Implement this plan?” prompts. - The TL;DR checkpoint aligns on direction before Codex drafts a long, decision-complete plan. ## Testing - Manual: built the local CLI and verified the flow now explores first, presents a TL;DR checkpoint, and only drafts the full plan after approval. --------- Co-authored-by: Nick Baumann <@openai.com>		2026-01-30 10:14:46 -08:00
..
src	Load exec policy rules from requirements (#10190 )	2026-01-30 18:04:09 +00:00
templates	plan mode: add TL;DR checkpoint and client behavior note (#10195 )	2026-01-30 10:14:46 -08:00
tests	fix: make sure the shell exists (#10222 )	2026-01-30 14:18:31 +01:00
BUILD.bazel	merge remote models (#9547 )	2026-01-20 14:02:07 -08:00
Cargo.toml	feat: sqlite 1 (#10004 )	2026-01-28 15:29:14 +01:00
config.schema.json	feat(app-server): support external auth mode (#10012 )	2026-01-29 23:46:04 +00:00
gpt-5.1-codex-max_prompt.md	Assemble sandbox/approval/network prompts dynamically (#8961 )	2026-01-12 23:12:59 +00:00
gpt-5.2-codex_prompt.md	Assemble sandbox/approval/network prompts dynamically (#8961 )	2026-01-12 23:12:59 +00:00
gpt_5_1_prompt.md	Assemble sandbox/approval/network prompts dynamically (#8961 )	2026-01-12 23:12:59 +00:00
gpt_5_2_prompt.md	Assemble sandbox/approval/network prompts dynamically (#8961 )	2026-01-12 23:12:59 +00:00
gpt_5_codex_prompt.md	Assemble sandbox/approval/network prompts dynamically (#8961 )	2026-01-12 23:12:59 +00:00
hierarchical_agents_message.md	Add hierarchical agent prompt (#8996 )	2026-01-09 13:47:37 -08:00
models.json	Update models.json (#9726 )	2026-01-23 00:44:47 +00:00
prompt.md	Assemble sandbox/approval/network prompts dynamically (#8961 )	2026-01-12 23:12:59 +00:00
prompt_with_apply_patch_instructions.md	Assemble sandbox/approval/network prompts dynamically (#8961 )	2026-01-12 23:12:59 +00:00
README.md	feat: add support for read-only bind mounts in the linux sandbox (#9112 )	2026-01-14 08:30:46 -08: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.

When using the workspace-write sandbox policy, the Seatbelt profile allows writes under the configured writable roots while keeping .git (directory or pointer file), the resolved gitdir: target, and .codex read-only.

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.