Open Codex is an open-source, community-maintained fork of OpenAI's Codex CLI tooling, maintained by ymichael on GitHub. It provides a terminal-based interface designed to execute code modifications, script runs, and automated development tasks directly from your shell environment. In standard workflows, Open Codex operates through the `codex-cli` interface. It processes natural language instructions, analyzes repository context, and generates or modifies source files while prompting users based on configurable execution safeguards. User preferences and runtime behaviors—such as automated tool execution and command confirmation levels—are managed via configuration files located at `~/.codex/config.json` or `~/.codex/config.yaml`, which can also be overridden via command-line flags. What differentiates Open Codex from the upstream repository and other commercial coding assistants is its community-driven fork status, which removes proprietary Contributor License Agreement (CLA) hurdles and incorporates community-submitted configuration improvements, such as persistent approval mode flags. It gives developers full access to the underlying TypeScript codebase for customization and local modifications. Open Codex is distributed as open-source software under its repository repository license. Usage costs depend strictly on the underlying model API keys configured for the agent.
Tags: ai agent, cli, code assistant, coding agent, terminal
codex-cli package. - Configurable Approval Modes — Supports fine-grained user confirmation workflows persistent across sessions via ~/.codex/config.json or ~/.codex/config.yaml. - Flag Overrides — Allows users to dynamically override default persistent approval and execution settings using CLI runtime flags. - TypeScript Implementation — Built on a modular TypeScript architecture that developers can inspect, extend, and rebuild locally. - Open-Source Fork — Independent community fork derived from openai/codex without upstream CLA requirements.approvalMode in ~/.codex/config.json. This ensures code modifications and shell commands require explicit approval before applying changes to disk.codex-cli to generate boilerplate, write helper scripts, and inspect error outputs without context switching to a browser or separate IDE plugin.Open Codex is targeted at developers who prefer terminal-native AI coding tools and want an open-source, configurable codebase rather than closed-source proprietary assistants. It is less suitable for users looking for turnkey desktop IDE extensions with full GUI integration or official enterprise vendor support.
codex-cli package directory using Node.js/npm: bash git clone https://github.com/ymichael/open-codex.git cd open-codex/codex-cli npm install npm run build npm link~/.codex/config.json (or ~/.codex/config.yaml): json { "approvalMode": "manual" } Export your API credentials in your environment: bash export OPENAI_API_KEY="your-api-key-here"codex against your current repository: bash codex "Add unit tests for user authentication in auth.ts and run test suite"Part of CLI Coding Agents
Categories: AI Coding Agents, Code Assistants, Developer Tools