← Back to all projects

Codex CLI
OpenAI's own terminal coding agent, written in Rust and fenced in by the operating system
OfficialApache-2.0
What is Codex CLI?
It works the way the other terminal agents do — read the repository, propose changes, run commands — but the boundary it enforces is unusual: on macOS and Linux it uses operating-system sandboxing to restrict which files and commands the agent can reach, so the limit does not depend on the model choosing to respect it. Sign-in runs through a ChatGPT plan or an OpenAI API key, which is the trade: the code is Apache-2.0, the model behind it is not the open part.
What can you do with Codex CLI?
- Work in the checkout you already have — It runs against the local repository from the terminal: inspecting code, editing files and running commands in place, with no upload step and no separate workspace to keep in sync.
- Decide the boundary before you need it — The permissions command sets what may be edited or executed without asking, and on macOS and Linux that choice is backed by operating-system sandboxing rather than by the agent's own restraint.
- Write the project's standing rules down once — An init command creates an AGENTS.md holding the instructions that should apply to every session — build commands, conventions, things not to touch — instead of repeating them in each prompt.
- Attach tools you already run — The mcp subcommand connects local or remote MCP servers, so internal services the agent should reach are configured once rather than wrapped in bespoke glue.
- Move the same task between surfaces — A cloud command hands work off to run remotely, an IDE extension covers VS Code, Cursor and Windsurf, and a desktop app is available — the CLI is one entry point among several into the same product.
Before you choose Codex CLI
- Authentication goes through a ChatGPT plan or an OpenAI API key, so unlike the multi-provider terminal agents in this category, the model behind it is not something you swap out freely.
- The operating-system sandbox is described for macOS and Linux; on Windows the same guarantee is not stated, so the approval settings carry more of the weight there.
Star history
21 Aug to 30 Oct · +20.6k
111k132k
Frequently asked questions
Is Codex CLI free for commercial use?
Codex CLI is released under the Apache-2.0 licence — OSI-approved open source, which permits commercial use.
How can Codex CLI be deployed?
Codex CLI is available as Runs locally.