This fork keeps the OpenAI Codex CLI foundation and turns it into a stronger local agent workspace: terminal sessions can share a backend, browser and phone clients can control those sessions, transcripts link back into your editor, and the packaged runtime comes with the tools an agent needs to get real work done.

The original upstream README is preserved at README_CODEX.md.

Build and run the fork locally:

nix build
./result/bin/codex

For development inside the repo:

nix develop
just codex "your prompt"

The Rust CLI and TUI live under codex-rs/. Fork-local feature notes live under wf_features/.

The local shared backend makes Codex controllable from more than one surface at the same time. A TUI can stay open on the workstation while a separate mobile-first web app connects to the same local app-server and controls those sessions from a browser or phone.

The remote-control website lives on the remote-control-web branch in the standalone web/ package. It connects to codex app-server, shows local threads, follows live session updates, sends new prompts, interrupts running turns, handles approval requests, and can be installed as a Home Screen app from its HTTPS origin.

That is the main reason the shared backend exists: Codex stops being a single terminal process and becomes a local agent backend with multiple useful clients.

See local shared app server, connected auto-reconnect, and the remote-control-web web app.

Run TUI sessions against a shared local app-server without giving up local working-directory behavior. The resume picker, latest-session lookup, cwd prompts, and normal local workflow still feel like local Codex, while the session is available to other clients.

The TUI also shows when it is connected to a shared backend and automatically recovers from backend restarts when it can.

See connected footer badge.

Saved sessions are easier to recognize because Codex generates short thread titles automatically. Terminal/window titles also track the active Codex view, so multiple Codex windows from the same repo are easier to tell apart.

See automatic thread title and active view terminal titles.

When the assistant references a file, Codex turns that reference into a clickable terminal link. When the assistant includes a normal markdown link, that link is clickable too. Review output becomes something you can navigate directly instead of text you have to copy by hand.

See clickable assistant file references.

@file completion can surface ignored files when you explicitly type into the local path that contains them. This keeps broad search clean while still letting you mention generated files, local-only config, or ignored scratch artifacts when you actually ask for them.

See file mentions include path-local ignored files.

The status card, footer, and configurable status line show whether usage is ahead of or behind pace for the current limit window. Labels such as weekly +40% make the useful question visible: not just how much quota remains, but whether the current pace is sustainable.

See usage limit pace indicator.

Ctrl+I copies the current unsent prompt from the composer. This is useful when a prompt needs to move into another tool, another Codex session, or a bug report without sending it first.

See copy unsent prompt text.

Restricted-network Linux sandboxing still allows local Unix-domain socket IPC, so helper daemons and bridge processes can coordinate locally without opening internet sockets.

The Nix-packaged CLI also includes a curated baseline toolbelt on PATH, including common development tools and PDF utilities, so shell-driven agent work is less dependent on whatever happens to be installed on the host.

See packaged common binaries.

Custom builds identify themselves in codex --version and in the TUI session header, making screenshots, logs, and bug reports much easier to interpret.

See custom build version labels.

• Connected TUI sessions no longer imply context usage before that data is actually known.
• Stale MCP startup banners are cleared after resume.
• Session recording retries after transient persistence failures instead of treating one write failure as permanent loss.
• Workspace-write overrides for apply_patch and approval flows are fixed.
• Linux/Nix build prerequisites are restored for this fork.
• Linux sandbox debug builds avoid fortify warning noise.

• Active view terminal titles
• Automatic thread title
• Clickable assistant file references
• Connected auto-reconnect
• Connected footer badge
• Copy unsent prompt text
• Custom build version labels
• File mentions include path-local ignored files
• Local shared app server
• Packaged common binaries
• Session persistence retries
• Usage limit pace indicator

For the upstream project overview, install instructions, and general Codex links, see README_CODEX.md. This repository remains licensed under the Apache-2.0 License.