diff --git a/docs/adapters/codex-local.md b/docs/adapters/codex-local.md index 5a18cc2178..927e7cf3b0 100644 --- a/docs/adapters/codex-local.md +++ b/docs/adapters/codex-local.md @@ -41,8 +41,12 @@ When `fastMode` is enabled, Paperclip adds Codex config overrides equivalent to: Paperclip currently applies that only when the selected model is `gpt-5.4`. On other models, the toggle is preserved in config but ignored at execution time to avoid unsupported runs. +## Managed `CODEX_HOME` + When Paperclip is running inside a managed worktree instance (`PAPERCLIP_IN_WORKTREE=true`), the adapter instead uses a worktree-isolated `CODEX_HOME` under the Paperclip instance so Codex skills, sessions, logs, and other runtime state do not leak across checkouts. It seeds that isolated home from the user's main Codex home for shared auth/config continuity. +## Manual Local CLI + For manual local CLI usage outside heartbeat runs (for example running as `codexcoder` directly), use: ```sh diff --git a/packages/adapters/codex-local/src/server/test.ts b/packages/adapters/codex-local/src/server/test.ts index 6e8db205e4..f19ed0078c 100644 --- a/packages/adapters/codex-local/src/server/test.ts +++ b/packages/adapters/codex-local/src/server/test.ts @@ -139,7 +139,7 @@ export async function testEnvironment( hint: "Use the `codex` CLI command to run the automatic login and installation probe.", }); } else { - const execArgs = buildCodexExecArgs(config); + const execArgs = buildCodexExecArgs({ ...config, fastMode: false }); const args = execArgs.args; if (execArgs.fastModeIgnoredReason) { checks.push({