agentsys 5.3.4 → 5.3.5

package/.claude-plugin/marketplace.json

@@ -1,7 +1,7 @@
 {
   "name": "agentsys",
   "description": "14 specialized plugins for AI workflow automation - task orchestration, PR workflow, slop detection, code review, drift detection, enhancement analysis, documentation sync, repo mapping, perf investigations, topic research, agent config linting, cross-tool AI consultation, and structured AI debate",
-  "version": "5.3.4",
+  "version": "5.3.5",
   "owner": {
     "name": "Avi Fenesh",
     "url": "https://github.com/avifenesh"

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agentsys",
-  "version": "5.3.4",
+  "version": "5.3.5",
   "description": "Professional-grade slash commands for Claude Code with cross-platform support",
   "keywords": [
     "workflow",

package/CHANGELOG.md

@@ -7,6 +7,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [5.3.5] - 2026-03-02
+
+### Fixed
+
+- **Kiro commands install to ~/.kiro/prompts/** - Commands now install as prompts (invoked with `@name` in kiro-cli) instead of steering files. Legacy `~/.kiro/steering/` auto-cleaned on install.
+- **Cursor installs globally to ~/.cursor/** - Previously project-scoped (`cwd/.cursor/`). Now global like all other platforms.
+- **Agent resources updated** - Kiro agents reference `file://.kiro/prompts/**/*.md`.
+
 ## [5.3.4] - 2026-03-02
 
 ### Fixed

package/bin/cli.js

@@ -946,9 +946,8 @@ function detectInstalledPlatforms() {
   const opencodeDir = getOpenCodeConfigDir();
   if (fs.existsSync(opencodeDir)) platforms.push('opencode');
   if (fs.existsSync(path.join(home, '.codex'))) platforms.push('codex');
-  // Cursor rules are project-scoped; detect only if Cursor rules/commands/skills exist in CWD
-  const cursorDir = path.join(process.cwd(), '.cursor');
-  if (fs.existsSync(path.join(cursorDir, 'rules')) || fs.existsSync(path.join(cursorDir, 'commands')) || fs.existsSync(path.join(cursorDir, 'skills'))) platforms.push('cursor');
+  // Cursor: detect global ~/.cursor/ or project .cursor/
+  if (fs.existsSync(path.join(home, '.cursor')) || fs.existsSync(path.join(process.cwd(), '.cursor'))) platforms.push('cursor');
   // Kiro: detect global ~/.kiro/ or project .kiro/
   if (fs.existsSync(path.join(home, '.kiro')) || fs.existsSync(path.join(process.cwd(), '.kiro'))) platforms.push('kiro');
   return platforms;
@@ -1606,12 +1605,13 @@ function installForCodex(installDir, options = {}) {
 function installForCursor(installDir, options = {}) {
   console.log('\n[INSTALL] Installing for Cursor...\n');
   const { filter = null } = options;
-  const cwd = process.cwd();
+  const home = process.env.HOME || process.env.USERPROFILE;
 
-  // Create target directories (all project-scoped)
-  const skillsDir = path.join(cwd, '.cursor', 'skills');
-  const commandsDir = path.join(cwd, '.cursor', 'commands');
-  const rulesDir = path.join(cwd, '.cursor', 'rules');
+  // Install globally to ~/.cursor/ (same as other platforms)
+  const cursorHome = path.join(home, '.cursor');
+  const skillsDir = path.join(cursorHome, 'skills');
+  const commandsDir = path.join(cursorHome, 'commands');
+  const rulesDir = path.join(cursorHome, 'rules');
   fs.mkdirSync(skillsDir, { recursive: true });
   fs.mkdirSync(commandsDir, { recursive: true });
   fs.mkdirSync(rulesDir, { recursive: true });
@@ -1694,7 +1694,7 @@ function installForCursor(installDir, options = {}) {
   console.log(`\n[OK] Cursor installation complete!`);
   console.log(`   Skills: ${skillCount} installed to ${skillsDir}`);
   console.log(`   Commands: ${cmdCount} installed to ${commandsDir}`);
-  console.log('   All content is project-scoped and auto-loaded by Cursor.\n');
+  console.log(`   Global install: ${cursorHome}\n`);
   return true;
 }
 
@@ -1706,18 +1706,30 @@ function installForKiro(installDir, options = {}) {
   const home = process.env.HOME || process.env.USERPROFILE;
   const kiroHome = path.join(home, '.kiro');
   const skillsDir = path.join(kiroHome, 'skills');
-  const steeringDir = path.join(kiroHome, 'steering');
+  const promptsDir = path.join(kiroHome, 'prompts');
   const agentsDir = path.join(kiroHome, 'agents');
   fs.mkdirSync(skillsDir, { recursive: true });
-  fs.mkdirSync(steeringDir, { recursive: true });
+  fs.mkdirSync(promptsDir, { recursive: true });
   fs.mkdirSync(agentsDir, { recursive: true });
 
-  // Cleanup old agentsys steering files (only those matching known commands)
+  // Clean up legacy agentsys files from steering dir (renamed to prompts).
+  // Only remove files matching known plugin commands - preserve user steering files.
+  const legacySteeringDir = path.join(kiroHome, 'steering');
+  if (fs.existsSync(legacySteeringDir)) {
+    const knownLegacy = new Set(steeringMappingsForCleanup.map(([name]) => `${name}.md`));
+    for (const f of fs.readdirSync(legacySteeringDir).filter(f => f.endsWith('.md'))) {
+      if (knownLegacy.has(f)) {
+        fs.unlinkSync(path.join(legacySteeringDir, f));
+      }
+    }
+  }
+
+  // Cleanup old agentsys prompt files (only those matching known commands)
   const steeringMappingsForCleanup = discovery.getKiroSteeringMappings(installDir);
-  const knownSteeringFiles = new Set(steeringMappingsForCleanup.map(([name]) => `${name}.md`));
-  for (const f of fs.readdirSync(steeringDir).filter(f => f.endsWith('.md'))) {
-    if (knownSteeringFiles.has(f)) {
-      fs.unlinkSync(path.join(steeringDir, f));
+  const knownPromptFiles = new Set(steeringMappingsForCleanup.map(([name]) => `${name}.md`));
+  for (const f of fs.readdirSync(promptsDir).filter(f => f.endsWith('.md'))) {
+    if (knownPromptFiles.has(f)) {
+      fs.unlinkSync(path.join(promptsDir, f));
     }
   }
 
@@ -1776,12 +1788,12 @@ function installForKiro(installDir, options = {}) {
     }
   }
 
-  // Install commands as steering files
+  // Install commands as prompts (invoked with @ in kiro-cli)
   const steeringMappings = discovery.getKiroSteeringMappings(installDir);
-  let steeringCount = 0;
-  for (const [steeringName, plugin, sourceFile, description] of steeringMappings) {
+  let promptCount = 0;
+  for (const [promptName, plugin, sourceFile, description] of steeringMappings) {
     if (filter && filter.commands && filter.commands.length > 0) {
-      if (!filter.commands.includes(steeringName)) continue;
+      if (!filter.commands.includes(promptName)) continue;
     }
     const srcPath = path.join(installDir, 'plugins', plugin, 'commands', sourceFile);
     if (!fs.existsSync(srcPath)) {
@@ -1791,11 +1803,11 @@ function installForKiro(installDir, options = {}) {
     let content = fs.readFileSync(srcPath, 'utf8');
     content = transforms.transformCommandForKiro(content, {
       pluginInstallPath: path.join(installDir, 'plugins', plugin),
-      name: steeringName,
+      name: promptName,
       description
     });
-    fs.writeFileSync(path.join(steeringDir, `${steeringName}.md`), content);
-    steeringCount++;
+    fs.writeFileSync(path.join(promptsDir, `${promptName}.md`), content);
+    promptCount++;
   }
 
   // Install agents as JSON files
@@ -1845,7 +1857,7 @@ function installForKiro(installDir, options = {}) {
 
   console.log(`\n[OK] Kiro installation complete!`);
   console.log(`   Skills: ${skillCount} installed to ${skillsDir}`);
-  console.log(`   Steering: ${steeringCount} installed to ${steeringDir}`);
+  console.log(`   Prompts: ${promptCount} installed to ${promptsDir} (invoke with @name in kiro-cli)`);
   console.log(`   Agents: ${agentCount} installed to ${agentsDir} (includes 2 combined reviewers)`);
   console.log(`   Global install: ${kiroHome}\n`);
   return true;
@@ -1867,8 +1879,8 @@ function removeInstallation() {
   console.log('  - Claude: /plugin marketplace remove agentsys');
   console.log('  - OpenCode: Remove files under ~/.config/opencode/ (commands/*.md, agents/*.md, skills/*/SKILL.md) and ~/.config/opencode/plugins/agentsys.ts');
   console.log('  - Codex: Remove ~/.codex/skills/*/');
-  console.log('  - Cursor: Remove .cursor/skills/, .cursor/commands/, and .cursor/rules/agentsys-*.mdc from your project');
-  console.log('  - Kiro: Remove ~/.kiro/skills/, ~/.kiro/steering/, and ~/.kiro/agents/');
+  console.log('  - Cursor: Remove ~/.cursor/skills/, ~/.cursor/commands/, and ~/.cursor/rules/agentsys-*.mdc');
+  console.log('  - Kiro: Remove ~/.kiro/skills/, ~/.kiro/prompts/, and ~/.kiro/agents/');
 }
 
 function printSubcommandHelp(subcommand) {
@@ -2030,8 +2042,8 @@ Supported Platforms:
   claude   - Claude Code (marketplace install or development mode)
   opencode - OpenCode (local commands + native plugin)
   codex    - Codex CLI (local skills)
-  cursor   - Cursor (project-scoped skills + commands)
-  kiro     - Kiro (project-scoped steering + skills + agents)
+  cursor   - Cursor (global ~/.cursor/ skills + commands)
+  kiro     - Kiro (global ~/.kiro/ prompts + skills + agents)
 
 Install:  npm install -g agentsys && agentsys
 Update:   npm update -g agentsys && agentsys

package/lib/adapter-transforms.js

@@ -454,7 +454,7 @@ function transformSkillForKiro(content, options) {
 }
 
 /**
- * Transform command content for Kiro steering files.
+ * Transform command content for Kiro prompt files.
  *
  * Strips existing frontmatter, prepends inclusion: manual frontmatter,
  * replaces PLUGIN_ROOT paths, removes require()/Task() calls, strips namespaces.
@@ -622,7 +622,7 @@ function transformAgentForKiro(content, options) {
     agent.tools = ['read'];
   }
 
-  agent.resources = ['file://.kiro/steering/**/*.md'];
+  agent.resources = ['file://.kiro/prompts/**/*.md'];
 
   return JSON.stringify(agent, null, 2);
 }
@@ -646,7 +646,7 @@ function generateCombinedReviewerAgent(roles, name, description) {
     description,
     prompt: `You are a combined code reviewer covering multiple review passes in a single session.\n\n${sections}\n\nFor each file you review, check ALL of the above review dimensions. Return findings as a JSON array with objects containing: pass (which review), file, line, severity (critical/high/medium/low), description, suggestion.`,
     tools: ['read'],
-    resources: ['file://.kiro/steering/**/*.md'],
+    resources: ['file://.kiro/prompts/**/*.md'],
   };
 
   return JSON.stringify(agent, null, 2);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentsys",
-  "version": "5.3.4",
+  "version": "5.3.5",
   "description": "A modular runtime and orchestration system for AI agents - works with Claude Code, OpenCode, and Codex CLI",
   "main": "lib/platform/detect-platform.js",
   "type": "commonjs",

package/site/content.json

@@ -1,11 +1,11 @@
 {
   "meta": {
     "title": "agentsys",
-    "description": "A modular runtime and orchestration system for AI agents. 12 plugins, 41 agents, 27 skills — structured pipelines for Claude Code, OpenCode, and Codex CLI.",
+    "description": "A modular runtime and orchestration system for AI agents. 14 plugins, 43 agents, 30 skills — structured pipelines for Claude Code, OpenCode, Codex CLI, Cursor, and Kiro.",
     "url": "https://agent-sh.github.io/agentsys",
     "repo": "https://github.com/agent-sh/agentsys",
     "npm": "https://www.npmjs.com/package/agentsys",
-    "version": "5.3.4",
+    "version": "5.3.5",
     "author": "Avi Fenesh",
     "author_url": "https://github.com/avifenesh"
   },
@@ -43,12 +43,12 @@
       "suffix": ""
     },
     {
-      "value": "3,357",
+      "value": "3,709",
       "label": "Tests",
       "suffix": ""
     },
     {
-      "value": "3",
+      "value": "5",
       "label": "Platforms",
       "suffix": ""
     }
@@ -98,7 +98,7 @@
     {
       "name": "/agnix",
       "tagline": "Lint agent configs before they break",
-      "description": "155 validation rules (57 auto-fixable) for Skills, Memory, Hooks, MCP, and Plugins across 10+ AI tools including Claude Code, Cursor, GitHub Copilot, Codex CLI, OpenCode, and Gemini CLI. SARIF output for GitHub Code Scanning.",
+      "description": "230+ validation rules (57 auto-fixable) for Skills, Memory, Hooks, MCP, and Plugins across 10+ AI tools including Claude Code, Cursor, Kiro, GitHub Copilot, Codex CLI, OpenCode, and Gemini CLI. SARIF output for GitHub Code Scanning.",
       "example": "/agnix --fix",
       "category": "linting"
     },
@@ -168,9 +168,23 @@
     {
       "name": "/consult",
       "tagline": "Get a second opinion from another AI tool",
-      "description": "Cross-tool AI consultation. Ask Gemini, Codex, Claude, OpenCode, or Copilot for a second opinion on any question. Supports session continuations, context injection, and configurable thinking effort.",
+      "description": "Cross-tool AI consultation via ACP (Agent Client Protocol). Ask Gemini, Codex, Claude, OpenCode, Copilot, or Kiro for a second opinion. Supports ACP and CLI transports, session continuations, context injection, and user-extensible provider registry.",
       "example": "/consult \"Is this the right approach?\" --tool=gemini --effort=high",
       "category": "analysis"
+    },
+    {
+      "name": "/debate",
+      "tagline": "Structured adversarial debate between AI tools",
+      "description": "Multi-round structured debates between any two AI tools as proposer and challenger. Evidence-backed arguments, mandatory counterpoints, and a verdict from the orchestrator. Supports ACP transport for Kiro participation.",
+      "example": "/debate claude vs kiro about microservices vs monolith",
+      "category": "analysis"
+    },
+    {
+      "name": "/web-ctl",
+      "tagline": "Browser automation for AI agents",
+      "description": "Navigate, authenticate, and interact with web pages via headless Playwright. Persistent encrypted sessions, human-in-the-loop auth handoff with CAPTCHA detection, and anti-bot measures.",
+      "example": "/web-ctl browse https://example.com",
+      "category": "maintenance"
     }
   ],
   "philosophy": [
@@ -235,12 +249,22 @@
       "opencode": {
         "name": "OpenCode",
         "prefix": "/",
-        "state_dir": ".opencode/"
+        "state_dir": "~/.config/opencode/"
       },
       "codex": {
         "name": "Codex CLI",
         "prefix": "$",
-        "state_dir": ".codex/"
+        "state_dir": "~/.codex/"
+      },
+      "cursor": {
+        "name": "Cursor",
+        "prefix": "/",
+        "state_dir": ".cursor/"
+      },
+      "kiro": {
+        "name": "Kiro",
+        "prefix": "steering",
+        "state_dir": "~/.kiro/"
       }
     }
   },