prr-kit 1.0.0 → 1.1.0

package/README.md

@@ -12,13 +12,13 @@ Module system, agent YAML, step-file workflows, CLI installer with full IDE inte
 
 ```bash
 # Install into your repo (interactive — recommended)
-npx pr-review install
+npx prr-kit install
 
-# Or run directly
-node tools/cli/prr-cli.js install --directory /path/to/repo
+# Or use the alias
+npx pr-review install
 
 # Silent install with defaults (edit config.yaml afterward)
-node tools/cli/prr-cli.js install --directory /path/to/repo --modules prr --tools claude-code --yes
+npx prr-kit install --directory /path/to/repo --modules prr --tools claude-code --yes
 ```
 
 Then open your IDE in the installed project and use `/prr-master` to start.
@@ -72,13 +72,15 @@ After install, edit `_prr/prr/config.yaml` in your project:
 user_name: YourName
 communication_language: English
 target_repo: .                        # path to the git repo to review (. = current dir)
-github_repo: "owner/repo"            # GitHub repo for gh pr list / inline comments
+platform: auto                        # auto-detect from git remote, or: github / gitlab / azure / bitbucket
+platform_repo: "owner/repo"          # required for PR listing and posting inline comments
 output_folder: _prr-output
 review_output: /abs/path/_prr-output/reviews
 ```
 
-> `github_repo` is required for `gh pr list`, `gh pr diff`, and posting inline GitHub comments.
-> Leave empty to use local branch selection only.
+> `platform` defaults to `auto` — detects GitHub/GitLab/Azure/Bitbucket from the git remote URL.
+> `platform_repo` is required for PR listing (`gh pr list`, `glab mr list`, etc.) and posting inline comments.
+> Leave `platform_repo` empty to use local branch selection only.
 
 ## Platform Support
 
@@ -127,14 +129,14 @@ Only pauses once to ask which PR/branch to review.
 
 ### Selecting a PR (SP step)
 
-**With `github_repo` configured** — lists open GitHub PRs:
+**With `platform_repo` configured** — lists open PRs/MRs via platform CLI:
 ```
 #45  "Add OAuth2 login"      feature/oauth → main    @alice  3h ago
 #44  "Fix memory leak"       fix/memory    → main    @bob    1d ago
 ```
-Enter PR number → base and head resolved automatically from GitHub.
+Enter PR number → base and head resolved automatically.
 
-**Without `github_repo`** — asks explicitly for both branches:
+**Without `platform_repo`** — asks explicitly for both branches:
 ```
 🎯 Head branch (the branch to review)?
    • Enter a number from the list  (e.g., 1)
@@ -149,13 +151,10 @@ Enter PR number → base and head resolved automatically from GitHub.
 
 | Agent | Slash Command | Speciality |
 |-------|--------------|------------|
-| PRR Master | `/prr-master` | Orchestrator — routes all workflows |
-| Alex | `/general-reviewer` | Code quality, logic, naming, DRY |
-| Sam | `/security-reviewer` | OWASP Top 10, secrets, auth |
-| Petra | `/performance-reviewer` | N+1 queries, memory leaks, async |
-| Arch | `/architecture-reviewer` | SOLID, layers, coupling, consistency |
+| PRR Master | `/prr-master` | Orchestrator — routes all workflows, full menu |
+| PRR Quick | `/prr-quick` | One-command full pipeline (select → review → report) |
 
-Each reviewer agent can also be invoked directly and has its own menu.
+Specialist reviewer agents (Alex, Sam, Petra, Arch) are orchestrated internally by the master agent and party-mode workflow. Use `[PM] Party Mode` from the master menu to run all 4 reviewers in a collaborative session.
 
 ## Severity Levels
 
@@ -166,24 +165,34 @@ All findings use a standard format:
 - 🟢 **[SUGGESTION]** — Nice-to-have improvement
 - 📌 **[QUESTION]** — Needs clarification from author
 
-## Inline GitHub Comments
+## Inline Code Comments
 
-When `[PC] Post Comments` is run with `github_repo` configured, it uses the GitHub Reviews API to post findings as **inline code comments** on the exact file and line — the same experience as a human reviewer on GitHub.
+When `[PC] Post Comments` is run with `platform_repo` configured, it posts findings as **inline code comments** on the exact file and line — the same experience as a human reviewer.
 
-Requires `gh` CLI authenticated: `gh auth login`
+| Platform | Method | Required CLI |
+|----------|--------|-------------|
+| GitHub | Reviews API | `gh auth login` |
+| GitLab | MR Discussions API | `glab auth login` |
+| Azure DevOps | PR Threads API | `az login` |
+| Bitbucket | Inline Comments REST API | `bb` / `curl` |
 
 ## Supported IDEs
 
-- **Claude Code** (preferred)
-- **Cursor** (preferred)
-- **Windsurf** (preferred)
-- Cline, Roo, Gemini CLI, Kiro
+**Preferred:**
+- **Claude Code**, **Cursor**, **Windsurf**
+
+**Also supported:**
+- Antigravity, Auggie, Cline, Codex, Crush, Gemini CLI, GitHub Copilot, iFlow, Kilo, Kiro, OpenCode, QwenCoder, Roo Cline, Rovo Dev, Trae
 
 ## Requirements
 
-- Node.js 18+
+- Node.js 20+
 - Git
-- `gh` CLI — required for `gh pr list`, `gh pr diff`, and posting inline GitHub comments
+- Platform CLI (optional — only needed for PR listing and inline comments):
+  - GitHub: [`gh`](https://cli.github.com/)
+  - GitLab: [`glab`](https://gitlab.com/gitlab-org/cli)
+  - Azure DevOps: [`az`](https://learn.microsoft.com/en-us/cli/azure/) + Azure DevOps extension
+  - Bitbucket: [`bb`](https://bitbucket.org/atlassian/bitbucket-cli) or `curl`
 
 ## Development
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prr-kit",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "AI-driven Pull Request Review Framework — structured agent workflows for thorough, consistent code review",
   "main": "tools/cli/prr-cli.js",
   "bin": {

package/tools/cli/installers/lib/ide/_config-driven.js

@@ -17,6 +17,11 @@ class ConfigDrivenIdeSetup extends BaseIdeSetup {
   async setup(projectDir, prrDir, options = {}) {
     if (!this.installerConfig) return { success: false, reason: 'no-config' };
 
+    // Multi-target support (e.g. opencode: agents → one dir, workflows → another)
+    if (this.installerConfig.targets) {
+      return this._setupMultiTarget(projectDir, prrDir, options);
+    }
+
     await this.cleanup(projectDir, options);
 
     const { target_dir, template_type } = this.installerConfig;
@@ -114,6 +119,71 @@ class ConfigDrivenIdeSetup extends BaseIdeSetup {
     return { success: true, results };
   }
 
+  async _setupMultiTarget(projectDir, prrDir, options = {}) {
+    const results = { agents: 0, workflows: 0 };
+    const selectedModules = options.selectedModules || ['prr'];
+    const allModules = ['core', ...selectedModules.filter((m) => m !== 'core')];
+
+    for (const target of this.installerConfig.targets) {
+      const { target_dir, template_type, artifact_types } = target;
+      const targetPath = path.join(projectDir, target_dir);
+      await this.ensureDir(targetPath);
+
+      const installAgents = !artifact_types || artifact_types.includes('agents');
+      const installWorkflows = !artifact_types || artifact_types.includes('workflows');
+
+      if (installAgents) {
+        for (const mod of allModules) {
+          const agentsDir = path.join(prrDir, mod, 'agents');
+          if (!(await fs.pathExists(agentsDir))) continue;
+          const agentFiles = await glob('**/*.md', { cwd: agentsDir });
+          for (const agentFile of agentFiles) {
+            const agentContent = await fs.readFile(path.join(agentsDir, agentFile), 'utf8');
+            if (/^no-launcher:\s*true/m.test(agentContent)) continue;
+            const nameMatch = agentContent.match(/^name:\s*[\"']?([^\"'\n]+)[\"']?/m);
+            const descMatch = agentContent.match(/^description:\s*[\"']?([^\"'\n]+)[\"']?/m);
+            const agentName = nameMatch?.[1]?.trim() || path.basename(agentFile, '.md');
+            const agentDesc = descMatch?.[1]?.trim() || `${agentName} reviewer`;
+            const relAgentPath = `${mod}/agents/${agentFile}`.replaceAll('\\', '/');
+            const launcherContent = this.generateAgentLauncher(agentName, agentDesc, relAgentPath, template_type);
+            const launcherFileName = `${path.basename(agentFile, '.md')}.md`;
+            await fs.writeFile(path.join(targetPath, launcherFileName), launcherContent, 'utf8');
+            results.agents++;
+          }
+        }
+      }
+
+      if (installWorkflows) {
+        for (const mod of allModules) {
+          const workflowsDir = path.join(prrDir, mod, 'workflows');
+          if (!(await fs.pathExists(workflowsDir))) continue;
+          const workflowFiles = await glob('**/workflow{.md,.yaml}', { cwd: workflowsDir });
+          for (const wfFile of workflowFiles) {
+            const wfContent = await fs.readFile(path.join(workflowsDir, wfFile), 'utf8');
+            let wfName = path.basename(path.dirname(wfFile));
+            let wfDesc = '';
+            if (wfFile.endsWith('.yaml')) {
+              try { const d = require('yaml').parse(wfContent); wfName = d.name || wfName; wfDesc = d.description || ''; } catch { /* ignore */ }
+            } else {
+              const normalized = wfContent.replace(/\r\n/g, '\n');
+              const fmMatch = normalized.match(/^---\n([\s\S]*?)\n---/);
+              if (fmMatch) { try { const fm = require('yaml').parse(fmMatch[1]); wfName = fm.name || wfName; wfDesc = fm.description || ''; } catch { /* ignore */ } }
+            }
+            const dirParts = path.dirname(wfFile).split(path.sep).filter(Boolean);
+            const leafDir = dirParts.at(-1) || wfName;
+            const relWfPath = `${mod}/workflows/${wfFile}`.replaceAll('\\', '/');
+            const launcherContent = this.generateWorkflowLauncher(wfName, wfDesc, relWfPath, template_type);
+            const launcherFileName = `prr-${leafDir}.md`;
+            await fs.writeFile(path.join(targetPath, launcherFileName), launcherContent, 'utf8');
+            results.workflows++;
+          }
+        }
+      }
+    }
+
+    return { success: true, results };
+  }
+
   generateAgentLauncher(name, description, agentRelPath, templateType) {
     const template = this.loadTemplate(`${templateType}-agent`) || this.loadTemplate('default-agent');
     return template

package/tools/cli/installers/lib/ide/codex.js

@@ -0,0 +1,128 @@
+/**
+ * Codex CLI setup handler
+ * Installs prompts to ~/.codex/prompts (global) or .codex/prompts (project)
+ */
+const path = require('node:path');
+const os = require('node:os');
+const { BaseIdeSetup } = require('./_base-ide');
+const fs = require('fs-extra');
+const { glob } = require('glob');
+const yaml = require('yaml');
+
+class CodexSetup extends BaseIdeSetup {
+  constructor() {
+    super('codex', 'Codex', false);
+  }
+
+  async setup(projectDir, prrDir, options = {}) {
+    const installLocation = options.preCollectedConfig?.installLocation || 'global';
+    const destDir = this._getPromptDir(projectDir, installLocation);
+    await fs.ensureDir(destDir);
+    await this._clearPrrFiles(destDir);
+
+    const selectedModules = options.selectedModules || ['prr'];
+    const allModules = ['core', ...selectedModules.filter((m) => m !== 'core')];
+    let count = 0;
+
+    // Write agent launchers
+    for (const mod of allModules) {
+      const agentsSrcDir = path.join(prrDir, mod, 'agents');
+      if (!(await fs.pathExists(agentsSrcDir))) continue;
+
+      const agentFiles = await glob('**/*.md', { cwd: agentsSrcDir });
+      for (const agentFile of agentFiles) {
+        const agentContent = await fs.readFile(path.join(agentsSrcDir, agentFile), 'utf8');
+        if (/^no-launcher:\s*true/m.test(agentContent)) continue;
+
+        const nameMatch = agentContent.match(/^name:\s*[\"']?([^\"'\n]+)[\"']?/m);
+        const agentName = nameMatch?.[1]?.trim() || path.basename(agentFile, '.md');
+        const relPath = `${this.prrFolderName}/${mod}/agents/${agentFile}`.replaceAll('\\', '/');
+
+        const content = `---
+name: '${agentName}'
+description: '${agentName} agent'
+disable-model-invocation: true
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from {project-root}/${relPath}
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. FOLLOW every step in the <activation> section precisely
+4. DISPLAY the welcome/greeting as instructed
+5. PRESENT the numbered menu
+6. WAIT for user input before proceeding
+</agent-activation>
+`;
+        const fileName = `prr-${mod}-${path.basename(agentFile, '.md')}.md`;
+        await fs.writeFile(path.join(destDir, fileName), content, 'utf8');
+        count++;
+      }
+    }
+
+    // Write workflow launchers
+    for (const mod of allModules) {
+      const workflowsSrcDir = path.join(prrDir, mod, 'workflows');
+      if (!(await fs.pathExists(workflowsSrcDir))) continue;
+
+      const workflowFiles = await glob('**/workflow{.md,.yaml}', { cwd: workflowsSrcDir });
+      for (const wfFile of workflowFiles) {
+        const wfContent = await fs.readFile(path.join(workflowsSrcDir, wfFile), 'utf8');
+        let wfName = path.basename(path.dirname(wfFile));
+
+        if (wfFile.endsWith('.yaml')) {
+          try { const d = yaml.parse(wfContent); wfName = d.name || wfName; } catch { /* ignore */ }
+        } else {
+          const normalized = wfContent.replace(/\r\n/g, '\n');
+          const fmMatch = normalized.match(/^---\n([\s\S]*?)\n---/);
+          if (fmMatch) { try { const fm = yaml.parse(fmMatch[1]); wfName = fm.name || wfName; } catch { /* ignore */ } }
+        }
+
+        const dirParts = path.dirname(wfFile).split(path.sep).filter(Boolean);
+        const leafDir = dirParts.at(-1) || wfName;
+        const relPath = `${this.prrFolderName}/${mod}/workflows/${wfFile}`.replaceAll('\\', '/');
+
+        const content = `---
+name: 'prr-${leafDir}'
+description: '${wfName}'
+disable-model-invocation: true
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL @{project-root}/${relPath}, READ its entire contents and follow its directions exactly!
+`;
+        const fileName = `prr-${mod}-${leafDir}.md`;
+        await fs.writeFile(path.join(destDir, fileName), content, 'utf8');
+        count++;
+      }
+    }
+
+    return { success: true, results: { agents: count, workflows: 0 } };
+  }
+
+  async cleanup(projectDir) {
+    for (const loc of ['global', 'project']) {
+      const dir = this._getPromptDir(projectDir, loc);
+      await this._clearPrrFiles(dir);
+    }
+  }
+
+  _getPromptDir(projectDir, location) {
+    if (location === 'project' && projectDir) {
+      return path.join(projectDir, '.codex', 'prompts');
+    }
+    return path.join(os.homedir(), '.codex', 'prompts');
+  }
+
+  async _clearPrrFiles(dir) {
+    if (!(await fs.pathExists(dir))) return;
+    const entries = await fs.readdir(dir);
+    for (const entry of entries) {
+      if (entry.startsWith('prr-') && entry.endsWith('.md')) {
+        await fs.remove(path.join(dir, entry));
+      }
+    }
+  }
+}
+
+module.exports = { CodexSetup };

package/tools/cli/installers/lib/ide/github-copilot.js

@@ -0,0 +1,262 @@
+/**
+ * GitHub Copilot setup handler
+ * Creates agents in .github/agents/, prompts in .github/prompts/,
+ * and generates copilot-instructions.md
+ */
+const path = require('node:path');
+const { BaseIdeSetup } = require('./_base-ide');
+const fs = require('fs-extra');
+const { glob } = require('glob');
+const yaml = require('yaml');
+
+class GitHubCopilotSetup extends BaseIdeSetup {
+  constructor() {
+    super('github-copilot', 'GitHub Copilot', false);
+    this.configDir = null;
+    this.githubDir = '.github';
+    this.agentsDir = 'agents';
+    this.promptsDir = 'prompts';
+    this.detectionPaths = ['.github/copilot-instructions.md', '.github/agents'];
+  }
+
+  async setup(projectDir, prrDir, options = {}) {
+    const githubDir = path.join(projectDir, this.githubDir);
+    const agentsDir = path.join(githubDir, this.agentsDir);
+    const promptsDir = path.join(githubDir, this.promptsDir);
+    await this.ensureDir(agentsDir);
+    await this.ensureDir(promptsDir);
+
+    await this.cleanup(projectDir);
+
+    const selectedModules = options.selectedModules || ['prr'];
+    const allModules = ['core', ...selectedModules.filter((m) => m !== 'core')];
+
+    let agentCount = 0;
+    let promptCount = 0;
+
+    // Install agent files to .github/agents/
+    for (const mod of allModules) {
+      const agentsSrcDir = path.join(prrDir, mod, 'agents');
+      if (!(await fs.pathExists(agentsSrcDir))) continue;
+
+      const agentFiles = await glob('**/*.md', { cwd: agentsSrcDir });
+      for (const agentFile of agentFiles) {
+        const agentPath = path.join(agentsSrcDir, agentFile);
+        const agentContent = await fs.readFile(agentPath, 'utf8');
+
+        if (/^no-launcher:\s*true/m.test(agentContent)) continue;
+
+        const nameMatch = agentContent.match(/^name:\s*[\"']?([^\"'\n]+)[\"']?/m);
+        const descMatch = agentContent.match(/^description:\s*[\"']?([^\"'\n]+)[\"']?/m);
+        const agentName = nameMatch?.[1]?.trim() || path.basename(agentFile, '.md');
+        const agentDesc = descMatch?.[1]?.trim() || `${agentName} reviewer`;
+        const relAgentPath = `${this.prrFolderName}/${mod}/agents/${agentFile}`.replaceAll('\\', '/');
+
+        const content = this._agentFileContent(agentName, agentDesc, relAgentPath);
+        const fileName = `prr-${path.basename(agentFile, '.md')}.agent.md`;
+        await fs.writeFile(path.join(agentsDir, fileName), content, 'utf8');
+        agentCount++;
+      }
+    }
+
+    // Install workflow prompts to .github/prompts/
+    for (const mod of allModules) {
+      const workflowsSrcDir = path.join(prrDir, mod, 'workflows');
+      if (!(await fs.pathExists(workflowsSrcDir))) continue;
+
+      const workflowFiles = await glob('**/workflow{.md,.yaml}', { cwd: workflowsSrcDir });
+      for (const wfFile of workflowFiles) {
+        const wfPath = path.join(workflowsSrcDir, wfFile);
+        const wfContent = await fs.readFile(wfPath, 'utf8');
+
+        let wfName = path.basename(path.dirname(wfFile));
+        let wfDesc = '';
+
+        if (wfFile.endsWith('.yaml')) {
+          try { const d = yaml.parse(wfContent); wfName = d.name || wfName; wfDesc = d.description || ''; } catch { /* ignore */ }
+        } else {
+          const normalized = wfContent.replace(/\r\n/g, '\n');
+          const fmMatch = normalized.match(/^---\n([\s\S]*?)\n---/);
+          if (fmMatch) {
+            try { const fm = yaml.parse(fmMatch[1]); wfName = fm.name || wfName; wfDesc = fm.description || ''; } catch { /* ignore */ }
+          }
+        }
+
+        const dirParts = path.dirname(wfFile).split(path.sep).filter(Boolean);
+        const leafDir = dirParts.at(-1) || wfName;
+        const relWfPath = `${this.prrFolderName}/${mod}/workflows/${wfFile}`.replaceAll('\\', '/');
+        const isYaml = wfFile.endsWith('.yaml');
+
+        const content = this._workflowPromptContent(wfName, wfDesc, relWfPath, isYaml);
+        const fileName = `prr-${leafDir}.prompt.md`;
+        await fs.writeFile(path.join(promptsDir, fileName), content, 'utf8');
+        promptCount++;
+      }
+    }
+
+    // Generate copilot-instructions.md
+    await this._generateCopilotInstructions(projectDir, prrDir, options);
+
+    return { success: true, results: { agents: agentCount, workflows: promptCount } };
+  }
+
+  _agentFileContent(name, description, agentPath) {
+    return `---
+description: '${description.replaceAll("'", "''")}'
+tools: ['read', 'edit', 'search', 'execute']
+disable-model-invocation: true
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from {project-root}/${agentPath}
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. FOLLOW every step in the <activation> section precisely
+4. DISPLAY the welcome/greeting as instructed
+5. PRESENT the numbered menu
+6. WAIT for user input before proceeding
+</agent-activation>
+`;
+  }
+
+  _workflowPromptContent(name, description, wfPath, isYaml) {
+    const safeDesc = (description || name).replaceAll("'", "''");
+    let body;
+    if (isYaml) {
+      body = `1. Load {project-root}/${this.prrFolderName}/prr/config.yaml and store ALL fields as session variables
+2. Load the workflow engine at {project-root}/${this.prrFolderName}/core/tasks/workflow.xml
+3. Load and execute the workflow at {project-root}/${wfPath} using the engine from step 2`;
+    } else {
+      body = `1. Load {project-root}/${this.prrFolderName}/prr/config.yaml and store ALL fields as session variables
+2. Load and follow the workflow at {project-root}/${wfPath}`;
+    }
+
+    return `---
+description: '${safeDesc}'
+agent: 'agent'
+tools: ['read', 'edit', 'search', 'execute']
+---
+
+${body}
+`;
+  }
+
+  async _generateCopilotInstructions(projectDir, prrDir, options = {}) {
+    const configPath = path.join(prrDir, 'prr', 'config.yaml');
+    let config = {};
+    if (await fs.pathExists(configPath)) {
+      try { config = yaml.parse(await fs.readFile(configPath, 'utf8')) || {}; } catch { /* ignore */ }
+    }
+
+    const prr = this.prrFolderName;
+    const section = `# PR Review Framework — Project Instructions
+
+## Project Configuration
+
+- **User**: ${config.user_name || 'Dev'}
+- **Communication Language**: ${config.communication_language || 'English'}
+- **Target Repo**: ${config.target_repo || '.'}
+- **Output Folder**: ${config.output_folder || '_prr-output'}
+- **Review Output**: ${config.review_output || '_prr-output/reviews'}
+
+## PRR Runtime Structure
+
+- **Agent definitions**: \`${prr}/core/agents/\` and \`${prr}/prr/agents/\`
+- **Workflow definitions**: \`${prr}/prr/workflows/\` (organized by phase)
+- **Core tasks**: \`${prr}/core/tasks/\`
+- **Module configuration**: \`${prr}/prr/config.yaml\`
+
+## Key Conventions
+
+- Always load \`${prr}/prr/config.yaml\` before any agent activation or workflow execution
+- MD-based workflows execute directly — load and follow the \`.md\` file
+- YAML-based workflows require the workflow engine — load \`core/tasks/workflow.xml\` first
+- The \`{project-root}\` variable resolves to the workspace root at runtime
+
+## Available Agents
+
+| Agent | Slash Command | Speciality |
+|-------|--------------|------------|
+| PRR Master | \`/prr-master\` | Orchestrator — routes all workflows |
+| PRR Quick | \`/prr-quick\` | One-command full pipeline |
+
+## Slash Commands
+
+Use \`#prr-\` in Copilot Chat to access PR Review prompts, or select agents from the agents dropdown.`;
+
+    const instructionsPath = path.join(projectDir, this.githubDir, 'copilot-instructions.md');
+    const markerStart = '<!-- PRR:START -->';
+    const markerEnd = '<!-- PRR:END -->';
+    const markedContent = `${markerStart}\n${section}\n${markerEnd}`;
+
+    if (await fs.pathExists(instructionsPath)) {
+      const existing = await fs.readFile(instructionsPath, 'utf8');
+      const startIdx = existing.indexOf(markerStart);
+      const endIdx = existing.indexOf(markerEnd);
+
+      if (startIdx !== -1 && endIdx !== -1 && endIdx > startIdx) {
+        const merged = existing.slice(0, startIdx) + markedContent + existing.slice(endIdx + markerEnd.length);
+        await fs.writeFile(instructionsPath, merged, 'utf8');
+      } else {
+        const backupPath = `${instructionsPath}.bak`;
+        await fs.copy(instructionsPath, backupPath);
+        await fs.writeFile(instructionsPath, `${markedContent}\n`, 'utf8');
+      }
+    } else {
+      await fs.writeFile(instructionsPath, `${markedContent}\n`, 'utf8');
+    }
+  }
+
+  async cleanup(projectDir, options = {}) {
+    // Clean agents
+    const agentsDir = path.join(projectDir, this.githubDir, this.agentsDir);
+    if (await fs.pathExists(agentsDir)) {
+      const files = await fs.readdir(agentsDir);
+      for (const file of files) {
+        if (file.startsWith('prr-') && file.endsWith('.agent.md')) {
+          await fs.remove(path.join(agentsDir, file));
+        }
+      }
+    }
+
+    // Clean prompts
+    const promptsDir = path.join(projectDir, this.githubDir, this.promptsDir);
+    if (await fs.pathExists(promptsDir)) {
+      const files = await fs.readdir(promptsDir);
+      for (const file of files) {
+        if (file.startsWith('prr-') && file.endsWith('.prompt.md')) {
+          await fs.remove(path.join(promptsDir, file));
+        }
+      }
+    }
+
+    // On uninstall, strip PRR markers from copilot-instructions.md
+    if (options.isUninstall) {
+      await this._cleanupCopilotInstructions(projectDir);
+    }
+  }
+
+  async _cleanupCopilotInstructions(projectDir) {
+    const instructionsPath = path.join(projectDir, this.githubDir, 'copilot-instructions.md');
+    if (!(await fs.pathExists(instructionsPath))) return;
+
+    const content = await fs.readFile(instructionsPath, 'utf8');
+    const markerStart = '<!-- PRR:START -->';
+    const markerEnd = '<!-- PRR:END -->';
+    const startIdx = content.indexOf(markerStart);
+    const endIdx = content.indexOf(markerEnd);
+    if (startIdx === -1 || endIdx === -1 || endIdx <= startIdx) return;
+
+    const cleaned = content.slice(0, startIdx) + content.slice(endIdx + markerEnd.length);
+    if (cleaned.trim().length === 0) {
+      await fs.remove(instructionsPath);
+      const backupPath = `${instructionsPath}.bak`;
+      if (await fs.pathExists(backupPath)) await fs.rename(backupPath, instructionsPath);
+    } else {
+      await fs.writeFile(instructionsPath, cleaned, 'utf8');
+    }
+  }
+}
+
+module.exports = { GitHubCopilotSetup };

package/tools/cli/installers/lib/ide/kilo.js

@@ -0,0 +1,132 @@
+/**
+ * KiloCoder IDE setup handler
+ * Creates custom modes in .kilocodemodes + workflow files in .kilocode/workflows/
+ */
+const path = require('node:path');
+const { BaseIdeSetup } = require('./_base-ide');
+const fs = require('fs-extra');
+const { glob } = require('glob');
+const yaml = require('yaml');
+
+class KiloSetup extends BaseIdeSetup {
+  constructor() {
+    super('kilo', 'KiloCoder', false);
+    this.configFile = '.kilocodemodes';
+  }
+
+  async setup(projectDir, prrDir, options = {}) {
+    await this.cleanup(projectDir);
+
+    const kiloModesPath = path.join(projectDir, this.configFile);
+    let config = {};
+    if (await fs.pathExists(kiloModesPath)) {
+      try { config = yaml.parse(await fs.readFile(kiloModesPath, 'utf8')) || {}; } catch { config = {}; }
+    }
+    if (!Array.isArray(config.customModes)) config.customModes = [];
+
+    const selectedModules = options.selectedModules || ['prr'];
+    const allModules = ['core', ...selectedModules.filter((m) => m !== 'core')];
+    let modeCount = 0;
+
+    // Add custom modes from agents
+    for (const mod of allModules) {
+      const agentsSrcDir = path.join(prrDir, mod, 'agents');
+      if (!(await fs.pathExists(agentsSrcDir))) continue;
+
+      const agentFiles = await glob('**/*.md', { cwd: agentsSrcDir });
+      for (const agentFile of agentFiles) {
+        const agentContent = await fs.readFile(path.join(agentsSrcDir, agentFile), 'utf8');
+        if (/^no-launcher:\s*true/m.test(agentContent)) continue;
+
+        const nameMatch = agentContent.match(/^name:\s*[\"']?([^\"'\n]+)[\"']?/m);
+        const descMatch = agentContent.match(/^description:\s*[\"']?([^\"'\n]+)[\"']?/m);
+        const agentName = nameMatch?.[1]?.trim() || path.basename(agentFile, '.md');
+        const agentDesc = descMatch?.[1]?.trim() || `${agentName} reviewer`;
+        const relPath = `${this.prrFolderName}/${mod}/agents/${agentFile}`.replaceAll('\\', '/');
+        const slug = `prr-${mod}-${path.basename(agentFile, '.md')}`;
+
+        config.customModes.push({
+          slug,
+          name: agentName,
+          roleDefinition: agentDesc,
+          whenToUse: `Use for ${agentName} tasks`,
+          customInstructions: `Read the full agent file from {project-root}/${relPath} and follow all activation instructions exactly.\n`,
+          groups: ['read', 'edit', 'browser', 'command', 'mcp'],
+        });
+        modeCount++;
+      }
+    }
+
+    await fs.writeFile(kiloModesPath, yaml.stringify(config, { lineWidth: 0 }), 'utf8');
+
+    // Write workflow files to .kilocode/workflows/
+    const workflowsDir = path.join(projectDir, '.kilocode', 'workflows');
+    await this.ensureDir(workflowsDir);
+    let wfCount = 0;
+
+    for (const mod of allModules) {
+      const workflowsSrcDir = path.join(prrDir, mod, 'workflows');
+      if (!(await fs.pathExists(workflowsSrcDir))) continue;
+
+      const workflowFiles = await glob('**/workflow{.md,.yaml}', { cwd: workflowsSrcDir });
+      for (const wfFile of workflowFiles) {
+        const wfContent = await fs.readFile(path.join(workflowsSrcDir, wfFile), 'utf8');
+        let wfName = path.basename(path.dirname(wfFile));
+        let wfDesc = '';
+
+        if (wfFile.endsWith('.yaml')) {
+          try { const d = yaml.parse(wfContent); wfName = d.name || wfName; wfDesc = d.description || ''; } catch { /* ignore */ }
+        } else {
+          const normalized = wfContent.replace(/\r\n/g, '\n');
+          const fmMatch = normalized.match(/^---\n([\s\S]*?)\n---/);
+          if (fmMatch) { try { const fm = yaml.parse(fmMatch[1]); wfName = fm.name || wfName; wfDesc = fm.description || ''; } catch { /* ignore */ } }
+        }
+
+        const dirParts = path.dirname(wfFile).split(path.sep).filter(Boolean);
+        const leafDir = dirParts.at(-1) || wfName;
+        const relPath = `${this.prrFolderName}/${mod}/workflows/${wfFile}`.replaceAll('\\', '/');
+
+        const content = `---
+name: 'prr-${leafDir}'
+description: '${wfDesc || wfName}'
+disable-model-invocation: true
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL @{project-root}/${relPath}, READ its entire contents and follow its directions exactly!
+`;
+        const fileName = `prr-${leafDir}.md`;
+        await fs.writeFile(path.join(workflowsDir, fileName), content, 'utf8');
+        wfCount++;
+      }
+    }
+
+    return { success: true, results: { agents: modeCount, workflows: wfCount } };
+  }
+
+  async cleanup(projectDir) {
+    // Remove prr- modes from .kilocodemodes
+    const kiloModesPath = path.join(projectDir, this.configFile);
+    if (await fs.pathExists(kiloModesPath)) {
+      try {
+        const config = yaml.parse(await fs.readFile(kiloModesPath, 'utf8')) || {};
+        if (Array.isArray(config.customModes)) {
+          config.customModes = config.customModes.filter((m) => !m.slug?.startsWith('prr-'));
+          await fs.writeFile(kiloModesPath, yaml.stringify(config, { lineWidth: 0 }), 'utf8');
+        }
+      } catch { /* ignore */ }
+    }
+
+    // Remove prr- workflow files
+    const workflowsDir = path.join(projectDir, '.kilocode', 'workflows');
+    if (await fs.pathExists(workflowsDir)) {
+      const files = await fs.readdir(workflowsDir);
+      for (const file of files) {
+        if (file.startsWith('prr-') && file.endsWith('.md')) {
+          await fs.remove(path.join(workflowsDir, file));
+        }
+      }
+    }
+  }
+}
+
+module.exports = { KiloSetup };

package/tools/cli/installers/lib/ide/manager.js

@@ -1,5 +1,9 @@
 /**
  * IDE Manager — dynamically loads and manages IDE handlers
+ *
+ * Loading strategy:
+ * 1. Custom installer files (github-copilot.js, codex.js, kilo.js) — unique installation logic
+ * 2. Config-driven handlers (from platform-codes.yaml) — standard IDE installation patterns
  */
 const path = require('node:path');
 const fs = require('fs-extra');
@@ -30,6 +34,36 @@ class IdeManager {
   }
 
   async loadHandlers() {
+    // 1. Load custom installer files first
+    await this._loadCustomHandlers();
+
+    // 2. Load config-driven handlers from platform-codes.yaml (skips platforms with custom handlers)
+    await this._loadConfigDrivenHandlers();
+  }
+
+  async _loadCustomHandlers() {
+    const customFiles = ['github-copilot.js', 'codex.js', 'kilo.js'];
+    const ideDir = __dirname;
+
+    for (const file of customFiles) {
+      const filePath = path.join(ideDir, file);
+      if (!fs.existsSync(filePath)) continue;
+
+      try {
+        const HandlerModule = require(filePath);
+        const HandlerClass = HandlerModule.default || Object.values(HandlerModule)[0];
+        if (!HandlerClass) continue;
+
+        const instance = new HandlerClass();
+        if (typeof instance.setPrrFolderName === 'function') {
+          instance.setPrrFolderName(this.prrFolderName);
+        }
+        this.handlers.set(instance.name, instance);
+      } catch { /* ignore load errors */ }
+    }
+  }
+
+  async _loadConfigDrivenHandlers() {
     const platformCodesPath = path.join(__dirname, 'platform-codes.yaml');
     const content = await fs.readFile(platformCodesPath, 'utf8');
     const config = yaml.parse(content);
@@ -37,7 +71,9 @@ class IdeManager {
     const { ConfigDrivenIdeSetup } = require('./_config-driven');
 
     for (const [code, info] of Object.entries(config.platforms || {})) {
-      if (!info.installer) continue;
+      if (!info.installer) continue;          // No installer = custom handler only
+      if (this.handlers.has(code)) continue;  // Already loaded as custom handler
+
       const handler = new ConfigDrivenIdeSetup(code, info);
       handler.setPrrFolderName(this.prrFolderName);
       this.handlers.set(code, handler);

package/tools/cli/installers/lib/ide/platform-codes.yaml

@@ -2,6 +2,7 @@
 # IDE/tool registry — defines where to install agent/workflow launchers
 
 platforms:
+  # Recommended Platforms
   claude-code:
     name: "Claude Code"
     preferred: true
@@ -29,6 +30,25 @@ platforms:
       target_dir: .windsurf/workflows
       template_type: windsurf
 
+  # Other IDEs and Tools
+  antigravity:
+    name: "Google Antigravity"
+    preferred: false
+    category: ide
+    description: "Google's AI development environment"
+    installer:
+      target_dir: .agent/workflows
+      template_type: antigravity
+
+  auggie:
+    name: "Auggie"
+    preferred: false
+    category: cli
+    description: "AI development tool"
+    installer:
+      target_dir: .augment/commands
+      template_type: default
+
   cline:
     name: "Cline"
     preferred: false
@@ -38,13 +58,20 @@ platforms:
       target_dir: .clinerules/workflows
       template_type: windsurf
 
-  roo:
-    name: "Roo Cline"
+  codex:
+    name: "Codex"
+    preferred: false
+    category: cli
+    description: "OpenAI Codex CLI"
+    # No installer config - uses custom codex.js
+
+  crush:
+    name: "Crush"
     preferred: false
     category: ide
-    description: "Enhanced Cline fork"
+    description: "AI development assistant"
     installer:
-      target_dir: .roo/commands
+      target_dir: .crush/commands
       template_type: default
 
   gemini:
@@ -54,8 +81,31 @@ platforms:
     description: "Google's CLI for Gemini"
     installer:
       target_dir: .gemini/commands
+      template_type: gemini
+
+  github-copilot:
+    name: "GitHub Copilot"
+    preferred: false
+    category: ide
+    description: "GitHub's AI pair programmer"
+    # No installer config - uses custom github-copilot.js
+
+  iflow:
+    name: "iFlow"
+    preferred: false
+    category: ide
+    description: "AI workflow automation"
+    installer:
+      target_dir: .iflow/commands
       template_type: default
 
+  kilo:
+    name: "KiloCoder"
+    preferred: false
+    category: ide
+    description: "AI coding platform"
+    # No installer config - uses custom kilo.js
+
   kiro:
     name: "Kiro"
     preferred: false
@@ -63,8 +113,58 @@ platforms:
     description: "Amazon's AI-powered IDE"
     installer:
       target_dir: .kiro/steering
+      template_type: kiro
+
+  opencode:
+    name: "OpenCode"
+    preferred: false
+    category: ide
+    description: "OpenCode terminal coding assistant"
+    installer:
+      targets:
+        - target_dir: .opencode/agent
+          template_type: opencode
+          artifact_types: [agents]
+        - target_dir: .opencode/command
+          template_type: opencode
+          artifact_types: [workflows]
+
+  qwen:
+    name: "QwenCoder"
+    preferred: false
+    category: ide
+    description: "Qwen AI coding assistant"
+    installer:
+      target_dir: .qwen/commands
       template_type: default
 
+  roo:
+    name: "Roo Cline"
+    preferred: false
+    category: ide
+    description: "Enhanced Cline fork"
+    installer:
+      target_dir: .roo/commands
+      template_type: default
+
+  rovo-dev:
+    name: "Rovo Dev"
+    preferred: false
+    category: ide
+    description: "Atlassian's Rovo development environment"
+    installer:
+      target_dir: .rovodev/workflows
+      template_type: rovodev
+
+  trae:
+    name: "Trae"
+    preferred: false
+    category: ide
+    description: "AI coding tool"
+    installer:
+      target_dir: .trae/rules
+      template_type: trae
+
 categories:
   ide:
     name: "Integrated Development Environment"

package/tools/cli/installers/lib/ide/templates/combined/antigravity-agent.md

@@ -0,0 +1,15 @@
+---
+name: '{{name}}'
+description: '{{description}}'
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from {project-root}/{{prrFolderName}}/{{path}}
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. FOLLOW every step in the <activation> section precisely
+4. DISPLAY the welcome/greeting as instructed
+5. PRESENT the numbered menu
+6. WAIT for user input before proceeding
+</agent-activation>

package/tools/cli/installers/lib/ide/templates/combined/antigravity-workflow.md

@@ -0,0 +1,8 @@
+---
+name: '{{name}}'
+description: '{{description}}'
+---
+
+Read the entire workflow file at: {project-root}/{{prrFolderName}}/{{path}}
+
+Follow all instructions in the workflow file exactly as written.

package/tools/cli/installers/lib/ide/templates/combined/gemini-agent.md

@@ -0,0 +1,16 @@
+---
+name: '{{name}}'
+description: '{{description}}'
+disable-model-invocation: true
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from {project-root}/{{prrFolderName}}/{{path}}
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. FOLLOW every step in the <activation> section precisely
+4. DISPLAY the welcome/greeting as instructed
+5. PRESENT the numbered menu
+6. WAIT for user input before proceeding
+</agent-activation>

package/tools/cli/installers/lib/ide/templates/combined/gemini-workflow.md

@@ -0,0 +1,7 @@
+---
+name: '{{name}}'
+description: '{{description}}'
+disable-model-invocation: true
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL @{project-root}/{{prrFolderName}}/{{path}}, READ its entire contents and follow its directions exactly!

package/tools/cli/installers/lib/ide/templates/combined/kiro-agent.md

@@ -0,0 +1,16 @@
+---
+inclusion: manual
+---
+
+# {{name}}
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from #[[file:{{prrFolderName}}/{{path}}]]
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. FOLLOW every step in the <activation> section precisely
+4. DISPLAY the welcome/greeting as instructed
+5. PRESENT the numbered menu
+6. WAIT for user input before proceeding
+</agent-activation>

package/tools/cli/installers/lib/ide/templates/combined/kiro-workflow.md

@@ -0,0 +1,9 @@
+---
+inclusion: manual
+---
+
+# {{name}}
+
+{{description}}
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL #[[file:{{prrFolderName}}/{{path}}]], READ its entire contents and follow its directions exactly!

package/tools/cli/installers/lib/ide/templates/combined/opencode-agent.md

@@ -0,0 +1,15 @@
+---
+name: '{{name}}'
+description: '{{description}}'
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+<agent-activation CRITICAL="TRUE">
+1. LOAD the FULL agent file from {project-root}/{{prrFolderName}}/{{path}}
+2. READ its entire contents - this contains the complete agent persona, menu, and instructions
+3. FOLLOW every step in the <activation> section precisely
+4. DISPLAY the welcome/greeting as instructed
+5. PRESENT the numbered menu
+6. WAIT for user input before proceeding
+</agent-activation>

package/tools/cli/installers/lib/ide/templates/combined/opencode-workflow.md

@@ -0,0 +1,6 @@
+---
+name: '{{name}}'
+description: '{{description}}'
+---
+
+IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL @{project-root}/{{prrFolderName}}/{{path}}, READ its entire contents and follow its directions exactly!

package/tools/cli/installers/lib/ide/templates/combined/rovodev-agent.md

@@ -0,0 +1,10 @@
+---
+name: '{{name}}'
+description: '{{description}}'
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+Read the entire agent file at: {project-root}/{{prrFolderName}}/{{path}}
+
+Follow all instructions in the agent file exactly as written.

package/tools/cli/installers/lib/ide/templates/combined/rovodev-workflow.md

@@ -0,0 +1,9 @@
+# {{name}}
+
+{{description}}
+
+---
+
+Read the entire workflow file at: {project-root}/{{prrFolderName}}/{{path}}
+
+Follow all instructions in the workflow file exactly as written.

package/tools/cli/installers/lib/ide/templates/combined/trae-agent.md

@@ -0,0 +1,11 @@
+# {{name}}
+
+{{description}}
+
+## Instructions
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified.
+
+Read the entire agent file at: {project-root}/{{prrFolderName}}/{{path}}
+
+Follow all instructions in the agent file exactly as written.

package/tools/cli/installers/lib/ide/templates/combined/trae-workflow.md

@@ -0,0 +1,9 @@
+# {{name}}
+
+{{description}}
+
+## Instructions
+
+Read the entire workflow file at: {project-root}/{{prrFolderName}}/{{path}}
+
+Follow all instructions in the workflow file exactly as written.