feat: add Codex app support

HARNESSES.md

@@ -12,6 +12,7 @@ Last verified: 2026-03-24
 | Claude Code | https://code.claude.com/docs/en/skills |
 | Cursor | https://cursor.com/docs/context/skills |
 | Gemini CLI | https://geminicli.com/docs/cli/skills/ |
+| Codex app | https://developers.openai.com/codex/using-codex/app/overview |
 | Codex CLI | https://developers.openai.com/codex/skills |
 | GitHub Copilot (Agents) | https://code.visualstudio.com/docs/copilot/customization/agent-skills |
 | Kiro | https://kiro.dev/docs/skills/ |
@@ -59,6 +60,7 @@ Notes:
 | Claude Code | `.claude/skills/` | - |
 | Cursor | `.cursor/skills/` | `.agents/skills/`, `.claude/skills/`, `.codex/skills/` |
 | Gemini CLI | `.gemini/skills/` | `.agents/skills/` |
+| Codex app | `.agents/skills/` | - |
 | Codex CLI | `.agents/skills/` (primary) | - |
 | GitHub Copilot | `.github/skills/` | `.agents/skills/`, `.claude/skills/` |
 | Kiro | `.kiro/skills/` | - |

README.md

@@ -2,7 +2,7 @@
 
 The vocabulary you didn't know you needed. 1 skill, 20 commands, and curated anti-patterns for impeccable frontend design.
 
-> **Quick start:** Visit [impeccable.style](https://impeccable.style) to download ready-to-use bundles.
+> **Quick start:** Visit [impeccable.style](https://impeccable.style) to download ready-to-use bundles for Codex CLI, Cursor, Claude Code, Gemini CLI, and more.
 
 ## Why Impeccable?
 
@@ -157,6 +157,13 @@ cp -r dist/gemini/.gemini your-project/
 >
 > [Learn more about Gemini CLI skills](https://geminicli.com/docs/cli/skills/)
 
+**Codex app / Copilot / Antigravity:**
+```bash
+cp -r dist/agents/.agents your-project/
+```
+
+> **Note:** This shared `.agents` bundle works for Codex app, VS Code Copilot, and Antigravity. Codex app discovers project skills from `.agents/skills` and reads instructions from `AGENTS.md` in the repo tree.
+
 **Codex CLI:**
 ```bash
 cp -r dist/codex/.codex/* ~/.codex/
@@ -195,10 +202,13 @@ Most commands accept an optional argument to focus on a specific area:
 /polish checkout-form
 ```
 
+**Codex app:** project-local skills are loaded from `.agents/skills`.
+
 **Note:** Codex CLI uses a different syntax: `/prompts:audit`, `/prompts:polish`, etc.
 
 ## Supported Tools
 
+- [Codex app](https://developers.openai.com/codex/using-codex/app/overview)
 - [Cursor](https://cursor.com)
 - [Claude Code](https://claude.ai/code)
 - [OpenCode](https://opencode.ai)

public/index.html

@@ -269,7 +269,7 @@ <h2 class="section-title">Install</h2>
                   </span>
                 </label>
               </div>
-              <span class="install-terminal-note">Contains all provider directories — extract to project root</span>
+              <span class="install-terminal-note">Contains all provider directories — extract to project root. <code>.agents/</code> works with Codex app, Copilot, and Antigravity.</span>
             </div>
           </div>
         </div>
@@ -394,6 +394,7 @@ <h2 class="section-title">Frequently Asked Questions</h2>
           <div class="faq-answer">
             <p>The easiest way is <code>npx skills add pbakaus/impeccable</code> — it auto-detects your AI harness and places files correctly.</p>
             <p>If you downloaded the <strong>universal ZIP</strong>, extract it to your <strong>project root</strong> (same level as your <code>package.json</code> or <code>src/</code> folder). It creates hidden folders for each supported tool: <code>.cursor/</code>, <code>.claude/</code>, <code>.gemini/</code>, <code>.codex/</code>, and <code>.agents/</code>.</p>
+            <p><code>.agents/</code> is the shared install target for Codex app, VS Code Copilot, and Antigravity. <code>.codex/</code> is the dedicated install target for Codex CLI.</p>
             <p>Project-level installation takes precedence and lets you version control your skills.</p>
           </div>
         </details>
@@ -419,6 +420,7 @@ <h2 class="section-title">Frequently Asked Questions</h2>
             <ul>
               <li><strong>Cursor:</strong> Requires Nightly channel + Agent Skills enabled in Settings → Rules</li>
               <li><strong>Gemini CLI:</strong> Requires <code>@google/gemini-cli@preview</code> + Skills enabled via <code>/settings</code></li>
+              <li><strong>Codex app:</strong> Reads <code>AGENTS.md</code> plus project-local skills from <code>.agents/skills/</code></li>
             </ul>
           </div>
         </details>
@@ -431,6 +433,7 @@ <h2 class="section-title">Frequently Asked Questions</h2>
               <li><strong>Claude Code:</strong> <a href="https://docs.anthropic.com/en/docs/claude-code" target="_blank" rel="noopener">Official Documentation</a></li>
               <li><strong>Cursor:</strong> <a href="https://docs.cursor.com" target="_blank" rel="noopener">Cursor Docs</a></li>
               <li><strong>Gemini CLI:</strong> <a href="https://geminicli.com/docs/" target="_blank" rel="noopener">Gemini CLI Docs</a></li>
+              <li><strong>Codex app:</strong> <a href="https://developers.openai.com/codex/using-codex/app/overview" target="_blank" rel="noopener">OpenAI Docs</a></li>
               <li><strong>Codex CLI:</strong> <a href="https://github.com/openai/codex" target="_blank" rel="noopener">Codex GitHub</a></li>
             </ul>
             <p>Once you're comfortable with basic prompting and code generation, come back and give Impeccable a try.</p>

scripts/build.js

@@ -8,7 +8,7 @@
  * - Claude Code: .claude/skills/
  * - Gemini: .gemini/skills/
  * - Codex: .codex/skills/
- * - Agents: .agents/skills/ (VS Code Copilot + Antigravity)
+ * - Agents: .agents/skills/ (Codex app, VS Code Copilot + Antigravity)
  *
  * Also assembles a universal ZIP containing all providers,
  * and builds Tailwind CSS for production deployment.
@@ -155,7 +155,7 @@ This folder contains skills for all supported tools:
   .claude/    → Claude Code
   .gemini/    → Gemini CLI
   .codex/     → Codex CLI
-  .agents/    → VS Code Copilot, Antigravity
+  .agents/    → Codex app, VS Code Copilot, Antigravity
   .kiro/      → Kiro
   .opencode/  → OpenCode
   .pi/        → Pi
@@ -167,7 +167,7 @@ These are hidden folders (dotfiles) — press Cmd+Shift+. in Finder to see them.
 `);
 
   const label = suffix ? ' (prefixed)' : '';
-  console.log(`✓ Assembled universal${label} directory (${providerConfigs.length} providers)`);
+  console.log(`✓ Assembled universal${label} directory (${providerConfigs.length} providers; .agents is shared by Codex app, Copilot, and Antigravity)`);
 }
 
 /**