openspec-playwright 0.1.39 → 0.1.40

package/README.md

@@ -18,21 +18,35 @@ openspec init              # Initialize OpenSpec
 openspec-pw init          # Install Playwright E2E integration
 ```
 
+## Supported AI Coding Assistants
+
+Auto-detects and installs commands for these editors:
+
+| Editor | Command | Format |
+|--------|---------|--------|
+| Claude Code | `/opsx:e2e` | Skill + command + MCP |
+| Cursor | `/opsx-e2e` | Command |
+| Windsurf | `/opsx-e2e` | Workflow |
+| Cline | `/opsx-e2e` | Workflow |
+| Continue | `/opsx-e2e` | Prompt |
+
+`openspec-pw init` detects which editors you have in your project and installs the appropriate files. Claude Code gets the full experience (skill + command + Playwright MCP). Other editors get command/workflow files with the complete E2E workflow.
+
 ## Usage
 
-### In Claude Code
+### In Your AI Coding Assistant
 
 ```bash
-/opsx:e2e my-feature    # Primary command (OpenSpec convention)
-/openspec-e2e           # Alternative from skill
+/opsx:e2e my-feature    # Claude Code
+/opsx-e2e my-feature   # Cursor, Windsurf, Cline, Continue
 ```
 
 ### CLI Commands
 
 ```bash
 openspec-pw init          # Initialize integration (one-time setup)
-openspec-pw update       # Update CLI and skill to latest version
-openspec-pw doctor       # Check prerequisites
+openspec-pw update        # Update CLI and commands to latest version
+openspec-pw doctor        # Check prerequisites
 ```
 
 ## How It Works
@@ -62,13 +76,16 @@ openspec-pw doctor       # Check prerequisites
 
 1. **Node.js >= 20**
 2. **OpenSpec** initialized: `npm install -g @fission-ai/openspec && openspec init`
-3. **Claude Code** with Playwright MCP configured
+3. **One of**: Claude Code, Cursor, Windsurf, Cline, or Continue (auto-detected)
+4. **Claude Code only**: Playwright MCP — `claude mcp add playwright npx @playwright/mcp@latest`
 
 ## What `openspec-pw init` Does
 
-1. Installs Playwright MCP globally via `claude mcp add`
-2. Installs `/opsx:e2e` command and `/openspec-e2e` skill
-3. Generates `tests/playwright/seed.spec.ts`, `auth.setup.ts`, `credentials.yaml`
+1. Detects installed AI coding assistants (Claude Code, Cursor, Windsurf, Cline, Continue)
+2. Installs E2E command/workflow files for each detected editor
+3. Installs `/openspec-e2e` skill for Claude Code
+4. Installs Playwright MCP globally for Claude Code (via `claude mcp add`)
+5. Generates `tests/playwright/seed.spec.ts`, `auth.setup.ts`, `credentials.yaml`
 
 > **Note**: After running `openspec-pw init`, manually install Playwright browsers: `npx playwright install --with-deps`
 
@@ -109,23 +126,30 @@ Edit `tests/playwright/credentials.yaml`:
 - Configure test user credentials
 - Add multiple users for role-based tests
 
-### MCP server
+### MCP server (Claude Code only)
 
-Playwright MCP is installed globally via `claude mcp add`. Restart Claude Code after setup to activate.
+Playwright MCP is installed globally via `claude mcp add` and enables the Healer Agent (auto-heals test failures via UI inspection). Restart Claude Code after setup to activate.
 
 ## Architecture
 
 ```
-openspec-pw (CLI - setup only)
-  ├── Installs Playwright agents (.github/)
-  ├── Installs Playwright MCP globally via claude mcp add
-  ├── Installs Claude Code skill (/openspec-e2e)
-  └── Installs command (/opsx:e2e)
-
-/openspec-e2e (Claude Code skill - runs in Claude)
-  ├── Reads OpenSpec specs
-  ├── Triggers Playwright agents via MCP
-  └── Generates E2E verification report
+Schema (openspec/schemas/playwright-e2e/)
+  └── Templates: test-plan.md, report.md, playwright.config.ts
+
+CLI (openspec-pw)
+  ├── init       → Installs commands for detected editors
+  ├── update     → Syncs commands + schema from npm
+  └── doctor     → Checks prerequisites
+
+Skill/Commands (per editor)
+  ├── Claude Code → /openspec-e2e (skill) + /opsx:e2e (command) + MCP
+  ├── Cursor      → /opsx-e2e (command)
+  ├── Windsurf    → /opsx-e2e (workflow)
+  ├── Cline       → /opsx-e2e (workflow)
+  └── Continue    → /opsx-e2e (prompt)
+
+Healer Agent (Claude Code + MCP only)
+  └── browser_snapshot, browser_navigate, browser_run_code, etc.
 ```
 
 ## License

package/README.zh-CN.md

@@ -18,27 +18,41 @@ openspec init              # 初始化 OpenSpec
 openspec-pw init          # 安装 Playwright E2E 集成
 ```
 
+## 支持的 AI 编码助手
+
+自动检测并安装以下编辑器的命令文件：
+
+| 编辑器 | 命令 | 格式 |
+|--------|------|------|
+| Claude Code | `/opsx:e2e` | Skill + 命令 + MCP |
+| Cursor | `/opsx-e2e` | 命令 |
+| Windsurf | `/opsx-e2e` | 工作流 |
+| Cline | `/opsx-e2e` | 工作流 |
+| Continue | `/opsx-e2e` | Prompt |
+
+`openspec-pw init` 会检测项目中安装了哪些编辑器并安装对应文件。Claude Code 获得完整体验（skill + 命令 + Playwright MCP）。其他编辑器获得包含完整 E2E 工作流的命令/工作流文件。
+
 ## 使用
 
-### 在 Claude Code 中
+### 在 AI 编码助手中
 
 ```bash
-/opsx:e2e my-feature    # 主命令（遵循 OpenSpec 规范）
-/openspec-e2e            # 来自 skill 的别名
+/opsx:e2e my-feature    # Claude Code
+/opsx-e2e my-feature   # Cursor, Windsurf, Cline, Continue
 ```
 
 ### CLI 命令
 
 ```bash
 openspec-pw init          # 初始化集成（一次性设置）
-openspec-pw update        # 更新 CLI 和 skill 到最新版本
+openspec-pw update        # 更新 CLI 和命令到最新版本
 openspec-pw doctor        # 检查前置条件
 ```
 
 ## 工作原理
 
 ```
-/openspec-e2e <change-name>
+/opsx:e2e <change-name>
   │
   ├── 1. 从 openspec/changes/<name>/specs/ 读取 OpenSpec specs
   │
@@ -46,7 +60,7 @@ openspec-pw doctor        # 检查前置条件
   │
   ├── 3. Generator Agent → 创建 tests/playwright/<name>.spec.ts
   │
-  └── 4. Healer Agent → 运行测试 + 自动修复失败
+  └── 4. Healer Agent → 运行测试 + 自动修复失败（Claude Code + MCP）
           │
           └── 报告: openspec/reports/playwright-e2e-<name>.md
 ```
@@ -62,13 +76,16 @@ openspec-pw doctor        # 检查前置条件
 
 1. **Node.js >= 20**
 2. **OpenSpec** 已初始化: `npm install -g @fission-ai/openspec && openspec init`
-3. **Claude Code** 已配置 Playwright MCP
+3. **任一**: Claude Code、Cursor、Windsurf、Cline 或 Continue（自动检测）
+4. **仅 Claude Code**: Playwright MCP — `claude mcp add playwright npx @playwright/mcp@latest`
 
 ## `openspec-pw init` 做了什么
 
-1. 通过 `claude mcp add` 全局安装 Playwright MCP
-2. 安装 `/opsx:e2e` 命令和 `/openspec-e2e` skill
-3. 生成 `tests/playwright/seed.spec.ts`、`auth.setup.ts`、`credentials.yaml`
+1. 检测已安装的 AI 编码助手（Claude Code、Cursor、Windsurf、Cline、Continue）
+2. 为每个检测到的编辑器安装 E2E 命令/工作流文件
+3. 为 Claude Code 安装 `/openspec-e2e` skill
+4. 为 Claude Code 全局安装 Playwright MCP（通过 `claude mcp add`）
+5. 生成 `tests/playwright/seed.spec.ts`、`auth.setup.ts`、`credentials.yaml`
 
 > **注意**：运行 `openspec-pw init` 后，手动安装 Playwright 浏览器：`npx playwright install --with-deps`
 
@@ -109,9 +126,9 @@ npx playwright test --project=setup
 - 配置测试用户凭证
 - 为角色测试添加多用户
 
-### MCP 服务器
+### MCP 服务器（仅 Claude Code）
 
-Playwright MCP 通过 `claude mcp add` 全局安装。设置后需重启 Claude Code 生效。
+Playwright MCP 通过 `claude mcp add` 全局安装，启用 Healer Agent（通过 UI 检查自动修复测试失败）。设置后需重启 Claude Code 生效。
 
 ## 许可
 

package/dist/commands/editors.d.ts

@@ -1,6 +1,6 @@
 /** Shared YAML escape — matches OpenSpec's escape logic */
 export declare function escapeYamlValue(value: string): string;
-/** Format tags as YAML inline array */
+/** Format tags as YAML inline array (escaped) */
 export declare function formatTagsArray(tags: string[]): string;
 /** Command metadata shared across editors */
 export interface CommandMeta {
@@ -13,19 +13,17 @@ export interface CommandMeta {
 }
 /** Editor adapter — Strategy Pattern */
 export interface EditorAdapter {
-    /** Tool identifier */
     toolId: string;
-    /** Whether this editor supports SKILL.md */
     hasSkill: boolean;
-    /** Get the command file path relative to project root */
     getCommandPath(commandId: string): string;
-    /** Format the complete file content */
     formatCommand(meta: CommandMeta): string;
 }
 /** Claude Code: .claude/commands/opsx/<id>.md + SKILL.md */
 declare const claudeAdapter: EditorAdapter;
 /** Detect which editors are installed by checking their config directories */
 export declare function detectEditors(projectRoot: string): EditorAdapter[];
+/** Detect Codex by checking if CODEX_HOME or ~/.codex exists */
+export declare function detectCodex(): EditorAdapter | null;
 /** Build the shared command metadata */
 export declare function buildCommandMeta(body: string): CommandMeta;
 /** Install command files for all detected editors */

package/dist/commands/editors.js

@@ -1,4 +1,5 @@
 import { existsSync, mkdirSync, writeFileSync } from 'fs';
+import { homedir } from 'os';
 import { join, dirname } from 'path';
 import chalk from 'chalk';
 /** Shared YAML escape — matches OpenSpec's escape logic */
@@ -10,17 +11,24 @@ export function escapeYamlValue(value) {
     }
     return value;
 }
-/** Format tags as YAML inline array */
+/** Format tags as YAML inline array (escaped) */
 export function formatTagsArray(tags) {
     return `[${tags.map(t => escapeYamlValue(t)).join(', ')}]`;
 }
+/** Format tags as YAML inline array (plain, no escaping) */
+function formatTagsPlain(tags) {
+    return `[${tags.join(', ')}]`;
+}
+/** Transform /opsx: to /opsx- for OpenCode */
+function transformToHyphenCommands(text) {
+    return text.replace(/\/opsx:/g, '/opsx-');
+}
+// ─── Claude Code ──────────────────────────────────────────────────────────────
 /** Claude Code: .claude/commands/opsx/<id>.md + SKILL.md */
 const claudeAdapter = {
     toolId: 'claude',
     hasSkill: true,
-    getCommandPath(id) {
-        return join('.claude', 'commands', 'opsx', `${id}.md`);
-    },
+    getCommandPath(id) { return join('.claude', 'commands', 'opsx', `${id}.md`); },
     formatCommand(meta) {
         return `---
 name: ${escapeYamlValue(meta.name)}
@@ -33,13 +41,12 @@ ${meta.body}
 `;
     },
 };
+// ─── Cursor ─────────────────────────────────────────────────────────────────
 /** Cursor: .cursor/commands/opsx-<id>.md */
 const cursorAdapter = {
     toolId: 'cursor',
     hasSkill: false,
-    getCommandPath(id) {
-        return join('.cursor', 'commands', `opsx-${id}.md`);
-    },
+    getCommandPath(id) { return join('.cursor', 'commands', `opsx-${id}.md`); },
     formatCommand(meta) {
         return `---
 name: /opsx-${meta.id}
@@ -52,13 +59,12 @@ ${meta.body}
 `;
     },
 };
+// ─── Windsurf ────────────────────────────────────────────────────────────────
 /** Windsurf: .windsurf/workflows/opsx-<id>.md */
 const windsurfAdapter = {
     toolId: 'windsurf',
     hasSkill: false,
-    getCommandPath(id) {
-        return join('.windsurf', 'workflows', `opsx-${id}.md`);
-    },
+    getCommandPath(id) { return join('.windsurf', 'workflows', `opsx-${id}.md`); },
     formatCommand(meta) {
         return `---
 name: ${escapeYamlValue(meta.name)}
@@ -71,13 +77,12 @@ ${meta.body}
 `;
     },
 };
+// ─── Cline ──────────────────────────────────────────────────────────────────
 /** Cline: .clinerules/workflows/opsx-<id>.md — markdown header only */
 const clineAdapter = {
     toolId: 'cline',
     hasSkill: false,
-    getCommandPath(id) {
-        return join('.clinerules', 'workflows', `opsx-${id}.md`);
-    },
+    getCommandPath(id) { return join('.clinerules', 'workflows', `opsx-${id}.md`); },
     formatCommand(meta) {
         return `# ${meta.name}
 
@@ -87,13 +92,12 @@ ${meta.body}
 `;
     },
 };
+// ─── Continue ────────────────────────────────────────────────────────────────
 /** Continue: .continue/prompts/opsx-<id>.prompt */
 const continueAdapter = {
     toolId: 'continue',
     hasSkill: false,
-    getCommandPath(id) {
-        return join('.continue', 'prompts', `opsx-${id}.prompt`);
-    },
+    getCommandPath(id) { return join('.continue', 'prompts', `opsx-${id}.prompt`); },
     formatCommand(meta) {
         return `---
 name: opsx-${meta.id}
@@ -105,13 +109,316 @@ ${meta.body}
 `;
     },
 };
-/** All supported adapters */
+// ─── amazon-q ─────────────────────────────────────────────────────────────
+/** Amazon Q: .amazonq/prompts/opsx-<id>.md */
+const amazonqAdapter = {
+    toolId: 'amazon-q',
+    hasSkill: false,
+    getCommandPath(id) { return join('.amazonq', 'prompts', `opsx-${id}.md`); },
+    formatCommand(meta) {
+        return `---
+description: ${escapeYamlValue(meta.description)}
+---
+
+${meta.body}
+`;
+    },
+};
+// ─── antigravity ──────────────────────────────────────────────────────────
+/** Antigravity: .agent/workflows/opsx-<id>.md */
+const antigravityAdapter = {
+    toolId: 'antigravity',
+    hasSkill: false,
+    getCommandPath(id) { return join('.agent', 'workflows', `opsx-${id}.md`); },
+    formatCommand(meta) {
+        return `---
+description: ${escapeYamlValue(meta.description)}
+---
+
+${meta.body}
+`;
+    },
+};
+// ─── auggie ────────────────────────────────────────────────────────────────
+/** Auggie: .augment/commands/opsx-<id>.md */
+const auggieAdapter = {
+    toolId: 'auggie',
+    hasSkill: false,
+    getCommandPath(id) { return join('.augment', 'commands', `opsx-${id}.md`); },
+    formatCommand(meta) {
+        return `---
+description: ${escapeYamlValue(meta.description)}
+argument-hint: command arguments
+---
+
+${meta.body}
+`;
+    },
+};
+// ─── codebuddy ─────────────────────────────────────────────────────────────
+/** CodeBuddy: .codebuddy/commands/opsx/<id>.md */
+const codebuddyAdapter = {
+    toolId: 'codebuddy',
+    hasSkill: false,
+    getCommandPath(id) { return join('.codebuddy', 'commands', 'opsx', `${id}.md`); },
+    formatCommand(meta) {
+        return `---
+name: ${escapeYamlValue(meta.name)}
+description: "${meta.description}"
+argument-hint: "[command arguments]"
+---
+
+${meta.body}
+`;
+    },
+};
+// ─── codex ────────────────────────────────────────────────────────────────
+/** Codex: <CODEX_HOME>/prompts/opsx-<id>.md — global scope */
+const codexAdapter = {
+    toolId: 'codex',
+    hasSkill: false,
+    getCommandPath(id) {
+        const codexHome = process.env.CODEX_HOME?.trim() || join(homedir(), '.codex');
+        return join(codexHome, 'prompts', `opsx-${id}.md`);
+    },
+    formatCommand(meta) {
+        return `---
+description: ${escapeYamlValue(meta.description)}
+argument-hint: command arguments
+---
+
+${meta.body}
+`;
+    },
+};
+// ─── costrict ─────────────────────────────────────────────────────────────
+/** CoStrict: .cospec/openspec/commands/opsx-<id>.md */
+const costrictAdapter = {
+    toolId: 'costrict',
+    hasSkill: false,
+    getCommandPath(id) { return join('.cospec', 'openspec', 'commands', `opsx-${id}.md`); },
+    formatCommand(meta) {
+        return `---
+description: "${meta.description}"
+argument-hint: command arguments
+---
+
+${meta.body}
+`;
+    },
+};
+// ─── crush ────────────────────────────────────────────────────────────────
+/** Crush: .crush/commands/opsx/<id>.md — tags plain join */
+const crushAdapter = {
+    toolId: 'crush',
+    hasSkill: false,
+    getCommandPath(id) { return join('.crush', 'commands', 'opsx', `${id}.md`); },
+    formatCommand(meta) {
+        return `---
+name: ${escapeYamlValue(meta.name)}
+description: ${escapeYamlValue(meta.description)}
+category: ${escapeYamlValue(meta.category)}
+tags: ${formatTagsPlain(meta.tags)}
+---
+
+${meta.body}
+`;
+    },
+};
+// ─── factory ───────────────────────────────────────────────────────────────
+/** Factory Droid: .factory/commands/opsx-<id>.md */
+const factoryAdapter = {
+    toolId: 'factory',
+    hasSkill: false,
+    getCommandPath(id) { return join('.factory', 'commands', `opsx-${id}.md`); },
+    formatCommand(meta) {
+        return `---
+description: ${escapeYamlValue(meta.description)}
+argument-hint: command arguments
+---
+
+${meta.body}
+`;
+    },
+};
+// ─── gemini ────────────────────────────────────────────────────────────────
+/** Gemini CLI: .gemini/commands/opsx/<id>.toml */
+const geminiAdapter = {
+    toolId: 'gemini',
+    hasSkill: false,
+    getCommandPath(id) { return join('.gemini', 'commands', 'opsx', `${id}.toml`); },
+    formatCommand(meta) {
+        return `description = "${meta.description}"
+
+prompt = """
+${meta.body}
+"""
+`;
+    },
+};
+// ─── github-copilot ────────────────────────────────────────────────────────
+/** GitHub Copilot: .github/prompts/opsx-<id>.prompt.md */
+const githubcopilotAdapter = {
+    toolId: 'github-copilot',
+    hasSkill: false,
+    getCommandPath(id) { return join('.github', 'prompts', `opsx-${id}.prompt.md`); },
+    formatCommand(meta) {
+        return `---
+description: ${escapeYamlValue(meta.description)}
+---
+
+${meta.body}
+`;
+    },
+};
+// ─── iflow ────────────────────────────────────────────────────────────────
+/** iFlow: .iflow/commands/opsx-<id>.md */
+const iflowAdapter = {
+    toolId: 'iflow',
+    hasSkill: false,
+    getCommandPath(id) { return join('.iflow', 'commands', `opsx-${id}.md`); },
+    formatCommand(meta) {
+        return `---
+name: /opsx-${meta.id}
+id: opsx-${meta.id}
+category: ${escapeYamlValue(meta.category)}
+description: ${escapeYamlValue(meta.description)}
+---
+
+${meta.body}
+`;
+    },
+};
+// ─── kilocode ────────────────────────────────────────────────────────────
+/** Kilo Code: .kilocode/workflows/opsx-<id>.md — body only */
+const kilocodeAdapter = {
+    toolId: 'kilocode',
+    hasSkill: false,
+    getCommandPath(id) { return join('.kilocode', 'workflows', `opsx-${id}.md`); },
+    formatCommand(meta) {
+        return `${meta.body}
+`;
+    },
+};
+// ─── kiro ─────────────────────────────────────────────────────────────────
+/** Kiro: .kiro/prompts/opsx-<id>.prompt.md */
+const kiroAdapter = {
+    toolId: 'kiro',
+    hasSkill: false,
+    getCommandPath(id) { return join('.kiro', 'prompts', `opsx-${id}.prompt.md`); },
+    formatCommand(meta) {
+        return `---
+description: ${escapeYamlValue(meta.description)}
+---
+
+${meta.body}
+`;
+    },
+};
+// ─── opencode ─────────────────────────────────────────────────────────────
+/** OpenCode: .opencode/commands/opsx-<id>.md — transforms /opsx: to /opsx- */
+const opencodeAdapter = {
+    toolId: 'opencode',
+    hasSkill: false,
+    getCommandPath(id) { return join('.opencode', 'commands', `opsx-${id}.md`); },
+    formatCommand(meta) {
+        const transformed = transformToHyphenCommands(meta.body);
+        return `---
+description: ${escapeYamlValue(meta.description)}
+---
+
+${transformed}
+`;
+    },
+};
+// ─── pi ──────────────────────────────────────────────────────────────────
+/** Pi: .pi/prompts/opsx-<id>.md */
+const piAdapter = {
+    toolId: 'pi',
+    hasSkill: false,
+    getCommandPath(id) { return join('.pi', 'prompts', `opsx-${id}.md`); },
+    formatCommand(meta) {
+        return `---
+description: ${escapeYamlValue(meta.description)}
+---
+
+${meta.body}
+`;
+    },
+};
+// ─── qoder ────────────────────────────────────────────────────────────────
+/** Qoder: .qoder/commands/opsx/<id>.md — tags plain join */
+const qoderAdapter = {
+    toolId: 'qoder',
+    hasSkill: false,
+    getCommandPath(id) { return join('.qoder', 'commands', 'opsx', `${id}.md`); },
+    formatCommand(meta) {
+        return `---
+name: ${escapeYamlValue(meta.name)}
+description: ${escapeYamlValue(meta.description)}
+category: ${escapeYamlValue(meta.category)}
+tags: ${formatTagsPlain(meta.tags)}
+---
+
+${meta.body}
+`;
+    },
+};
+// ─── qwen ────────────────────────────────────────────────────────────────
+/** Qwen Code: .qwen/commands/opsx-<id>.toml */
+const qwenAdapter = {
+    toolId: 'qwen',
+    hasSkill: false,
+    getCommandPath(id) { return join('.qwen', 'commands', `opsx-${id}.toml`); },
+    formatCommand(meta) {
+        return `description = "${meta.description}"
+
+prompt = """
+${meta.body}
+"""
+`;
+    },
+};
+// ─── roocode ─────────────────────────────────────────────────────────────
+/** RooCode: .roo/commands/opsx-<id>.md — markdown header */
+const roocodeAdapter = {
+    toolId: 'roocode',
+    hasSkill: false,
+    getCommandPath(id) { return join('.roo', 'commands', `opsx-${id}.md`); },
+    formatCommand(meta) {
+        return `# ${meta.name}
+
+${meta.description}
+
+${meta.body}
+`;
+    },
+};
+// ─── Detection map ───────────────────────────────────────────────────────
 const ALL_ADAPTERS = [
     claudeAdapter,
     cursorAdapter,
     windsurfAdapter,
     clineAdapter,
     continueAdapter,
+    amazonqAdapter,
+    antigravityAdapter,
+    auggieAdapter,
+    codebuddyAdapter,
+    codexAdapter,
+    costrictAdapter,
+    crushAdapter,
+    factoryAdapter,
+    geminiAdapter,
+    githubcopilotAdapter,
+    iflowAdapter,
+    kilocodeAdapter,
+    kiroAdapter,
+    opencodeAdapter,
+    piAdapter,
+    qoderAdapter,
+    qwenAdapter,
+    roocodeAdapter,
 ];
 /** Detect which editors are installed by checking their config directories */
 export function detectEditors(projectRoot) {
@@ -121,11 +428,35 @@ export function detectEditors(projectRoot) {
         ['.windsurf', windsurfAdapter],
         ['.clinerules', clineAdapter],
         ['.continue', continueAdapter],
+        ['.amazonq', amazonqAdapter],
+        ['.agent', antigravityAdapter],
+        ['.augment', auggieAdapter],
+        ['.codebuddy', codebuddyAdapter],
+        ['.cospec', costrictAdapter],
+        ['.crush', crushAdapter],
+        ['.factory', factoryAdapter],
+        ['.gemini', geminiAdapter],
+        ['.github', githubcopilotAdapter],
+        ['.iflow', iflowAdapter],
+        ['.kilocode', kilocodeAdapter],
+        ['.kiro', kiroAdapter],
+        ['.opencode', opencodeAdapter],
+        ['.pi', piAdapter],
+        ['.qoder', qoderAdapter],
+        ['.qwen', qwenAdapter],
+        ['.roo', roocodeAdapter],
     ];
     return checks
         .filter(([dir]) => existsSync(join(projectRoot, dir)))
         .map(([, adapter]) => adapter);
 }
+// ─── Codex is global — detect separately ─────────────────────────────────
+/** Detect Codex by checking if CODEX_HOME or ~/.codex exists */
+export function detectCodex() {
+    const codexHome = process.env.CODEX_HOME?.trim() || join(homedir(), '.codex');
+    return existsSync(codexHome) ? codexAdapter : null;
+}
+// ─── Install helpers ───────────────────────────────────────────────────────
 /** Build the shared command metadata */
 export function buildCommandMeta(body) {
     return {