From 7449b94521b9b1bf4955a578d54fb2d1c4cb6d53 Mon Sep 17 00:00:00 2001
From: Hinne Stolzenberg <hinne.stolzenberg@enthus.de>
Date: Thu, 25 Jun 2026 08:34:32 +0200
Subject: [PATCH] fix: NX-15814 Codex reads ~/.codex/AGENTS.md not CODEX.md

Codex instruction discovery is AGENTS.override.md -> AGENTS.md ->
project_doc_fallback_filenames; filenames not on that list are ignored, and
the default home config has no instructions_file pointer. So the CLI routing
block written to ~/.codex/CODEX.md was never read by Codex. Retarget the Codex
entry in GLOBAL_LLM_TOOLS + the SUPPORTED_TOOLS display string + the README to
~/.codex/AGENTS.md, which Codex does auto-load.

Claude-Session: https://claude.ai/code/session_01DT7GQh2psBVq2MmGoteU5g
---
 README.md         | 2 +-
 lib/llm/index.js  | 4 ++--
 package-lock.json | 4 ++--
 package.json      | 2 +-
 4 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index cb991fb..287c829 100644
--- a/README.md
+++ b/README.md
@@ -201,7 +201,7 @@ This tool teaches your AI coding assistants how to use these CLI tools by inject
 | ---------------- | --------------------- |
 | Claude Code      | `~/.claude/CLAUDE.md` |
 | Gemini CLI       | `~/.gemini/GEMINI.md` |
-| OpenAI Codex CLI | `~/.codex/CODEX.md`   |
+| OpenAI Codex CLI | `~/.codex/AGENTS.md`  |
 
 ### How It Works
 
diff --git a/lib/llm/index.js b/lib/llm/index.js
index 61627ae..9fb1d51 100644
--- a/lib/llm/index.js
+++ b/lib/llm/index.js
@@ -23,7 +23,7 @@ const GLOBAL_LLM_TOOLS = [
   {
     name: 'OpenAI Codex CLI',
     dir: '.codex',
-    file: 'CODEX.md',
+    file: 'AGENTS.md',
   },
 ];
 
@@ -1115,7 +1115,7 @@ const injectToLlmConfig = (tool) => {
 const SUPPORTED_TOOLS = [
   { name: 'Claude Code', config: '~/.claude/CLAUDE.md' },
   { name: 'Gemini CLI', config: '~/.gemini/GEMINI.md' },
-  { name: 'OpenAI Codex CLI', config: '~/.codex/CODEX.md' },
+  { name: 'OpenAI Codex CLI', config: '~/.codex/AGENTS.md' },
 ];
 
 /**
diff --git a/package-lock.json b/package-lock.json
index 98a14c8..75a3ab4 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "llm-cli-setup",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "llm-cli-setup",
-      "version": "1.7.0",
+      "version": "1.8.0",
       "license": "MIT",
       "dependencies": {
         "chalk": "^5.3.0",
diff --git a/package.json b/package.json
index 6af603c..fd464a7 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@enthus-appdev/llm-cli-setup",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "description": "CLI tools setup with LLM integration - installs and configures sqlcmd, gh, atl, n8nctl, grafanactl, logcli, m365, esq, discordctl, playwright, and hcloud with Claude Code, Gemini CLI, and Codex support",
   "type": "module",
   "main": "./lib/index.js",