From 10c89e9c2dc528ab5fabcf8df29db0441a53a484 Mon Sep 17 00:00:00 2001 From: rbbtsn0w Date: Thu, 19 Mar 2026 09:38:57 +0800 Subject: [PATCH 1/3] docs: clarify Codex CLI setup in README --- README.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index c70de1bae..2913e0204 100644 --- a/README.md +++ b/README.md @@ -173,7 +173,7 @@ See Spec-Driven Development in action across different scenarios with these comm | [Auggie CLI](https://docs.augmentcode.com/cli/overview) | ✅ | | | [Claude Code](https://www.anthropic.com/claude-code) | ✅ | | | [CodeBuddy CLI](https://www.codebuddy.ai/cli) | ✅ | | -| [Codex CLI](https://github.com/openai/codex) | ✅ | | +| [Codex CLI](https://github.com/openai/codex) | ✅ | Run `specify init . --ai codex` (or `specify init --here --ai codex`) to generate project-local `.codex/prompts`, then start Codex with `CODEX_HOME="$PWD/.codex"` so it loads them. In Codex CLI, invoke spec-kit prompts as `/prompts:speckit.specify`, `/prompts:speckit.plan`, etc. Restart Codex or start a new chat after prompt changes. OpenAI currently marks custom prompts as deprecated and recommends skills for reusable/shared workflows. | | [Cursor](https://cursor.sh/) | ✅ | | | [Gemini CLI](https://github.com/google-gemini/gemini-cli) | ✅ | | | [GitHub Copilot](https://code.visualstudio.com/) | ✅ | | @@ -297,7 +297,9 @@ specify check ### Available Slash Commands -After running `specify init`, your AI coding agent will have access to these slash commands for structured development: +After running `specify init`, your AI coding agent will have access to these slash commands for structured development. + +For Codex CLI specifically, spec-kit commands are generated into `.codex/prompts` and are invoked as `/prompts:speckit.` after starting Codex with `CODEX_HOME="$PWD/.codex"`. #### Core Commands From b90af83929d71219ffafa10b04d3550634fdf320 Mon Sep 17 00:00:00 2001 From: rbbtsn0w Date: Thu, 19 Mar 2026 09:53:18 +0800 Subject: [PATCH 2/3] docs: link Codex prompt deprecation guidance --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 2913e0204..cca0f7b2c 100644 --- a/README.md +++ b/README.md @@ -173,7 +173,7 @@ See Spec-Driven Development in action across different scenarios with these comm | [Auggie CLI](https://docs.augmentcode.com/cli/overview) | ✅ | | | [Claude Code](https://www.anthropic.com/claude-code) | ✅ | | | [CodeBuddy CLI](https://www.codebuddy.ai/cli) | ✅ | | -| [Codex CLI](https://github.com/openai/codex) | ✅ | Run `specify init . --ai codex` (or `specify init --here --ai codex`) to generate project-local `.codex/prompts`, then start Codex with `CODEX_HOME="$PWD/.codex"` so it loads them. In Codex CLI, invoke spec-kit prompts as `/prompts:speckit.specify`, `/prompts:speckit.plan`, etc. Restart Codex or start a new chat after prompt changes. OpenAI currently marks custom prompts as deprecated and recommends skills for reusable/shared workflows. | +| [Codex CLI](https://github.com/openai/codex) | ✅ | Run `specify init . --ai codex` (or `specify init --here --ai codex`) to generate project-local `.codex/prompts`, then start Codex with `CODEX_HOME="$PWD/.codex"` so it loads them. In Codex CLI, invoke spec-kit prompts as `/prompts:speckit.specify`, `/prompts:speckit.plan`, etc. Restart Codex or start a new chat after prompt changes. OpenAI marks [custom prompts](https://developers.openai.com/codex/custom-prompts) as deprecated and recommends [skills](https://developers.openai.com/codex/skills) for reusable/shared workflows. | | [Cursor](https://cursor.sh/) | ✅ | | | [Gemini CLI](https://github.com/google-gemini/gemini-cli) | ✅ | | | [GitHub Copilot](https://code.visualstudio.com/) | ✅ | | From fe7da299a8d0eb1c05b5cf2f6565aa0b8681d511 Mon Sep 17 00:00:00 2001 From: rbbtsn0w Date: Thu, 19 Mar 2026 09:55:13 +0800 Subject: [PATCH 3/3] docs: link Codex slash command behavior --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index cca0f7b2c..d6365f084 100644 --- a/README.md +++ b/README.md @@ -173,7 +173,7 @@ See Spec-Driven Development in action across different scenarios with these comm | [Auggie CLI](https://docs.augmentcode.com/cli/overview) | ✅ | | | [Claude Code](https://www.anthropic.com/claude-code) | ✅ | | | [CodeBuddy CLI](https://www.codebuddy.ai/cli) | ✅ | | -| [Codex CLI](https://github.com/openai/codex) | ✅ | Run `specify init . --ai codex` (or `specify init --here --ai codex`) to generate project-local `.codex/prompts`, then start Codex with `CODEX_HOME="$PWD/.codex"` so it loads them. In Codex CLI, invoke spec-kit prompts as `/prompts:speckit.specify`, `/prompts:speckit.plan`, etc. Restart Codex or start a new chat after prompt changes. OpenAI marks [custom prompts](https://developers.openai.com/codex/custom-prompts) as deprecated and recommends [skills](https://developers.openai.com/codex/skills) for reusable/shared workflows. | +| [Codex CLI](https://github.com/openai/codex) | ✅ | Run `specify init . --ai codex` (or `specify init --here --ai codex`) to generate project-local `.codex/prompts`, then start Codex with `CODEX_HOME="$PWD/.codex"` so it loads them. In Codex CLI, spec-kit commands are invoked through [custom prompts](https://developers.openai.com/codex/custom-prompts) as `/prompts:speckit.specify`, `/prompts:speckit.plan`, etc.; see the Codex CLI [slash commands](https://developers.openai.com/codex/cli/slash-commands) docs for command behavior. Restart Codex or start a new chat after prompt changes. OpenAI marks custom prompts as deprecated and recommends [skills](https://developers.openai.com/codex/skills) for reusable/shared workflows. | | [Cursor](https://cursor.sh/) | ✅ | | | [Gemini CLI](https://github.com/google-gemini/gemini-cli) | ✅ | | | [GitHub Copilot](https://code.visualstudio.com/) | ✅ | |