Feature/mount-config-dir-into-container

[braun-viathan]

Fixes #789

What?

This PR enhances run_in_container.sh by optionally mounting the user's local .codex configuration directory into the Docker container. This allows configuration and session persistence between container restarts.

Key Changes:

• Adds an optional --config flag.
• Default configuration path: $HOME/.codex if --config not provided.
• Updates usage examples and documentation.

Why?

• Currently, users lose Codex CLI configurations (approval modes, presets, logs) between container runs, as no persistent storage is provided. This change aligns Linux Docker behavior with other environments and improves the overall developer experience.

• Until the rust implementation will run stable with sandbox features for all OS, this improves the general experience for linux users with the containerized TS version until rust is ready.

How?

• Implemented optional bind mount based on the existence of the provided config directory.
• Ensured backward compatibility: no breaking changes for existing users who do not provide a config path.

Manual Testing Steps:

1. Build the container:

   ./codex-cli/scripts/build_container.sh

2. Execute Codex CLI with config mounted:

   ./codex-cli/scripts/run_in_container.sh \
     --work-dir "$(pwd)" \
     --config ~/.codex \
     "COMMAND"
     
     ./codex-cli/scripts/run_in_container.sh \
     "COMMAND"

3. Confirm that the mounted config is active (e.g., correct approval mode loaded).

Tested locally with success.

Checklist:

• Implementation

• Local testing: pnpm test && pnpm lint && pnpm typecheck -> Passed: log

• Manual testing done:

  • ~/.codex/config.yml contains: model: o4-mini & approvalMode: suggest, as you can see in the screenshot below the config is mounted and used correctly in the local conatiner run.

    

• Examples updated in run_in_container.sh

Open Question:

• Awaiting feedback if further unit or e2e are needed either to run locally or in ci before merging this one.

[braun-viathan]

Friendly ping @fouad-openai 😊

It’s been a few days and local tests are looking good.
This PR only adds an optional --config mount to run_in_container.sh so Linux users can persist their .codex settings (parity with macOS). No other logic changed.

When you have a moment, could you let me know if anything else is needed?
Thanks a lot!