$git clone https://github.com/atman-33/kiro-for-codexA VS Code extension that brings spec-driven development to Codex CLI. Manage your specs, steering documents, and custom prompts visually while leveraging Codex CLI's powerful AI capabilities.
| 1 | # Kiro for Codex |
| 2 | |
| 3 | [](https://marketplace.visualstudio.com/items?itemName=atman-dev.kiro-for-codex) |
| 4 | [](https://marketplace.visualstudio.com/items?itemName=atman-dev.kiro-for-codex) |
| 5 | [](https://github.com/atman-33/kiro-for-codex/stargazers) |
| 6 | [](https://github.com/atman-33/kiro-for-codex/issues) |
| 7 | |
| 8 | A VS Code extension that brings spec-driven development to Codex CLI. Manage your specs, steering documents, and custom prompts visually while leveraging Codex CLI's powerful AI capabilities. |
| 9 | |
| 10 | --- |
| 11 | |
| 12 | 💡 **Announcement**: |
| 13 | In the original **kiro-for-codex**, interacting with Codex required sending prompts through the terminal, which unfortunately reduced usability. To address this, I’ve been developing [**kiro-for-codex-ide**](https://github.com/atman-33/kiro-for-codex-ide), which passes the necessary prompts (such as those for spec creation) directly into the context of [Codex - OpenAI’s coding agent](https://marketplace.visualstudio.com/items?itemName=openai.chatgpt). |
| 14 | |
| 15 | This approach makes working with Codex much smoother, so moving forward I plan to focus development on **kiro-for-codex-ide** as the main project. |
| 16 | |
| 17 | --- |
| 18 | |
| 19 | ## Features |
| 20 | |
| 21 | ### ⚙️ Configuration |
| 22 | |
| 23 | - **Approval Modes**: The `kiroCodex.codex.defaultApprovalMode` setting now supports two modes: |
| 24 | - `full-auto`: (Default) Executes non-destructive commands automatically and asks for approval on failure. |
| 25 | - `yolo`: Executes all commands without approval. Use with caution. |
| 26 | |
| 27 | |
| 28 | ### 📝 SPEC Management |
| 29 | |
| 30 | - Create Specs: generate requirements, design, and task documents with Codex CLI |
| 31 | - Visual Explorer: browse and manage specs in the sidebar |
| 32 | - Spec Workflow: Requirements -> Design -> Tasks with a review at each step |
| 33 | - CodeLens for Tasks: execute an individual task from `tasks.md` via Codex and auto-check it off |
| 34 | |
| 35 | ### 🎯 STEERING Management |
| 36 | |
| 37 | - Steering Documents: browse and edit global/project-specific guidelines |
| 38 | - Generated Docs: product, tech, and structure steering documents |
| 39 | |
| 40 | ### 🧩 PROMPTS |
| 41 | |
| 42 | - Create Prompts: scaffold `.codex/prompts/<name>.md` from the Prompts view |
| 43 | - Click to Open: clicking a prompt opens the Markdown for review |
| 44 | - Inline Run Button: use the ▶ action on the right to execute with Codex CLI |
| 45 | - Organize & Refresh: manage a workspace prompt library with quick refresh |
| 46 | - Markdown Simplicity: no front-matter required; write plain Markdown instructions |
| 47 | |
| 48 | ### 💬 CHAT |
| 49 | |
| 50 | - Sidebar Chat (webview): start quick conversations with Codex inside VS Code |
| 51 | - Run once or stream: send a one-off message or stream via a dedicated Codex terminal session |
| 52 | - Stop anytime: terminate the active session from the Chat view |
| 53 | |
| 54 | ### 🚫 Temporarily Disabled Views/Flows |
| 55 | |
| 56 | - AGENTS, HOOKS, MCP views: hidden in this build |
| 57 | - "New Spec with Agents" flow: disabled |
| 58 | |
| 59 | ## Screenshot |
| 60 | |
| 61 |  |
| 62 | |
| 63 | The extension provides an organized sidebar for OVERVIEW, SPEC, STEERING, PROMPTS, and CHAT. Other views are hidden in this build. |
| 64 | |
| 65 | ## Installation |
| 66 | |
| 67 | ### Prerequisites |
| 68 | |
| 69 | - Codex CLI v0.28.0 or later installed and available on PATH |
| 70 | - VS Code 1.84.0 or later |
| 71 | |
| 72 | Compatibility: |
| 73 | |
| 74 | | Platform | Support | Notes | Status | |
| 75 | | -------------------- | ------- | ------------------------------------------ | -------- | |
| 76 | | macOS | Yes | Fully supported | released | |
| 77 | | Linux | Yes | Fully supported | released | |
| 78 | | Windows (WSL) | Yes | Supported with conditional path conversion | released | |
| 79 | | Windows (PowerShell) | Yes | Recommended on Windows |