codex-environment

What problem does it solve?

Codex worktrees require consistent local environment configuration, including environment.toml, and reproducible setup and cleanup processes.

Core Features & Use Cases

• Manage Codex Local Environments: create, inspect, and repair environment.toml and related worktree config.
• Setup and cleanup automation: provide hooks via scripts/worktree-up and scripts/worktree-down to prepare and restore worktrees.
• Workload isolation: copy and manage ignored env files (e.g., .env) per worktree to avoid cross-contamination.
• Reusable actions: expose Codex app actions (e.g., Dev, Typecheck, Unit tests, Lint) for quick access in the Codex UI.
• Environment portability: standardize environment patterns and environment.toml across worktrees for consistency.

Quick Start

Run scripts/worktree-up from the project root to initialize a new Codex worktree.