openai/codex

Developer Tools

A terminal coding agent from OpenAI that reads your repo, edits files and runs commands from a prompt.

131,390
20,748
Rust
Apache-2.0
1 year old

Codex CLI is worth a look if you already pay for a ChatGPT plan and want an agent inside your existing terminal workflow; otherwise weigh the configuration and background-process behaviour carefully before adopting it.

The problem

You have a task in a local repository — fix a failing test, add an endpoint, explain an unfamiliar module — and normally you would open an editor, hunt for the files, copy context into a chat window and paste changes back. Codex CLI moves that loop into the terminal: you describe the task, the agent works against the checked-out code, and you review the resulting edits and command output. The practical difference is fewer manual hops between reading code, asking a model and applying a patch.

What's different

This is OpenAI's own local agent rather than a wrapper around an API, and it is distributed as a standalone binary written in Rust, with npm, Homebrew and direct release downloads as documented installation routes. That matters if you dislike Node-based CLIs or want a single executable on a server or VM. The agent runs on your machine, so it operates on your working tree instead of a remote copy.

Authentication is the real dividing line. The README recommends signing in with a ChatGPT account and using the agent as part of a Plus, Pro, Business, Edu or Enterprise plan plan details; an API key is supported but requires extra setup auth docs. So the cost and access model is tied to OpenAI's subscription tiers, not a bare open-source tool you can point at any provider.

The most concrete trade-off in the discussion is the background daemon. A widely discussed HN thread is titled around Codex CLI installing a persistent, self-updating background daemon by default HN thread. One commenter described a feature-flag route to disable auto-start and noted files it writes under ~/.codex at startup comment; another said the daemon is useful when building apps on top of the daemon server reply. A separate commenter reported old versions accumulating on disk, estimating roughly 12 GB in total comment. These are user reports from 2026-10-12, not maintainer statements, and some may concern older versions. Treat them as questions to check against your installed version rather than established product facts.

Who should try it

Good fit: a developer already on a qualifying ChatGPT plan who works in a terminal and wants an agent that can read and modify the local checkout, especially on macOS or Linux where the install is a single script. Fit is weaker if you need a model-agnostic harness, if you are unwilling to run a self-updating background process, or if your environment forbids outbound install scripts. In those cases a manually downloaded release binary is a documented alternative path releases, but it does not change the OpenAI account requirement.

Requirements and limitations

Setup expects macOS, Linux or Windows, with install via a shell or PowerShell script, npm, Homebrew or a release archive; the README links a separate install guide for building from source. You need either a ChatGPT plan or an API key with the extra configuration described in the auth docs. The daemon behaviour described above is the main ongoing-upkeep question: whether it auto-starts, where it writes state, and how installed versions are cleaned up are things to confirm for your version. The README itself is thin on daemon, storage and uninstall details, so those decisions rest on docs and issue reports outside the excerpt supplied here.

HotRepo's take

The dated board sample is too sparse to judge momentum: four observed days between 2026-08-22 and 2026-10-28, the latest showing 131,379 stars with +308 that day project. Interest is clearly large, but persistence cannot be assessed from these snapshots. Before adopting, verify how the daemon and auto-update behave in your exact installed version, and whether disabling them fits your policy.

Written by AI from the project's README, updated October 28, 2026. The project's own docs are the source of truth.

Hacker News

Codex CLI installs a persistent, self-updating background daemon by default
▲ 610 · 294 comments · October 12, 2026
OpenAI Codex CLI: Lightweight coding agent that runs in your terminal
▲ 516 · 289 comments · April 16, 2025
Codex logging bug may write TBs to local SSDs
▲ 510 · 271 comments · June 22, 2026