Skip to content

Document Nix Codex CLI requirement - #399

Merged
ilysenko merged 1 commit into
mainfrom
codex/document-nix-cli-requirement
Jun 3, 2026
Merged

Document Nix Codex CLI requirement#399
ilysenko merged 1 commit into
mainfrom
codex/document-nix-cli-requirement

Conversation

@ilysenko

@ilysenko ilysenko commented Jun 3, 2026

Copy link
Copy Markdown
Owner

What changed

  • Added a Nix docs section explaining that the flake does not install the Codex CLI.
  • Documented that users should make codex available themselves or set CODEX_CLI_PATH.
  • Added a troubleshooting row for nix run appearing to do nothing while the launcher writes the real error to ~/.cache/codex-desktop/launcher.log.

Why

Issue #395 shows that Nix users can hit a silent-looking launch failure when the app starts successfully but stops at CLI lookup because the Codex CLI is missing. This was not the upstream patch drift fixed in #397; it is a Nix docs/UX gap.

Validation

  • git diff --check

@ilysenko ilysenko mentioned this pull request Jun 3, 2026
@ilysenko
ilysenko marked this pull request as ready for review June 3, 2026 13:32
@ilysenko
ilysenko merged commit 905f8d9 into main Jun 3, 2026
5 checks passed
Comment thread docs/nix.md
One option is the upstream npm package:

```bash
npm i -g @openai/codex

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think this is a good recommendation for nix users.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

would be better to provide a home-manager and nixos module that installs the codex cli package alongside

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants