@ryuenn3123/agentic-senior-core 5.2.0 → 5.4.0

package/README.md

@@ -7,7 +7,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
 
-**Install once. Works across all projects. Supports 16+ AI coding agents.**
+**Install once. Works across all projects. Supports 23+ AI coding agents.**
 
 </div>
 
@@ -75,13 +75,21 @@ This copies one file to `.cursor/rules/agentic-senior-core.mdc`. Cursor reads it
 </details>
 
 <details>
-<summary><b>Windsurf</b> (IDE)</summary>
+<summary><b>Windsurf / Devin Desktop</b> (IDE)</summary>
+
+Windsurf was acquired by Cognition and renamed to Devin Desktop. Use `--devin` for the preferred path:
+
+```bash
+asc adapter --devin
+```
+
+This copies one file to `.devin/rules/agentic-senior-core.md`. For legacy Windsurf installations:
 
 ```bash
 asc adapter --windsurf
 ```
 
-Copies one file to `.windsurf/rules/agentic-senior-core.md`. Repeat per project.
+Repeat per project.
 
 </details>
 
@@ -119,26 +127,123 @@ Copies one file to `.kiro/steering/agentic-senior-core.md`. Repeat per project.
 </details>
 
 <details>
-<summary><b>Google Antigravity</b> (IDE)</summary>
+<summary><b>Continue</b> (VS Code extension)</summary>
+
+```bash
+asc adapter --continue
+```
+
+Copies one file to `.continue/rules/agentic-senior-core.md`. Repeat per project.
+
+</details>
+
+<details>
+<summary><b>Zed</b> (IDE)</summary>
+
+```bash
+asc adapter --zed
+```
+
+Copies one file to `.zed/rules/agentic-senior-core.md`. Zed also reads `AGENTS.md` natively, so this is optional if you already have AGENTS.md in your project. Repeat per project.
+
+</details>
+
+<details>
+<summary><b>Aider</b> (terminal agent)</summary>
+
+```bash
+asc adapter --aider
+```
+
+Copies one file to `CONVENTIONS.md` at project root. Aider reads this automatically. Repeat per project.
+
+</details>
+
+<details>
+<summary><b>Kilo Code</b> (VS Code extension)</summary>
+
+```bash
+asc adapter --kilocode
+```
+
+Copies one file to `.kilocode/rules/agentic-senior-core.md`. Repeat per project.
+
+</details>
+
+<details>
+<summary><b>Roo Code</b> (VS Code extension)</summary>
+
+```bash
+asc adapter --roo
+```
+
+Copies one file to `.roo/rules/agentic-senior-core.md`. Repeat per project.
+
+</details>
+
+<details>
+<summary><b>OpenHands</b></summary>
+
+```bash
+asc adapter --openhands
+```
+
+Copies one file to `.openhands/microagents/agentic-senior-core.md`. Repeat per project.
+
+</details>
+
+<details>
+<summary><b>Google Antigravity IDE</b></summary>
 
 **Option A -- workspace rules (per project):**
 
-Copy `.agents/rules/agentic-senior-core.md` into your project. Antigravity reads it automatically with `trigger: always_on`.
+Copy the rules file into your project's `.agents/rules/` directory:
+
+```bash
+# Create the directory first, then copy
+mkdir -p .agents/rules
+
+# From the npm package (after Step 1)
+cp "$(npm root -g)/@ryuenn3123/agentic-senior-core/.agents/rules/agentic-senior-core.md" .agents/rules/
+```
+
+PowerShell (Windows):
+```powershell
+mkdir .agents\rules -Force
+cp "$(npm root -g)/@ryuenn3123/agentic-senior-core/.agents/rules/agentic-senior-core.md" .agents\rules\
+```
+
+Antigravity IDE reads it automatically with `trigger: always_on`.
 
 **Option B -- global plugin (all projects):**
 
-```bash
-# Via Antigravity CLI
-agy plugin install https://github.com/fatidaprilian/Agentic-Senior-Core.git
+Copy the plugin bundle to Antigravity's global plugin directory:
+
+```powershell
+# Windows
+xcopy /E /I "%APPDATA%\npm\node_modules\@ryuenn3123\agentic-senior-core\.agents\plugins\agentic-senior-core" "%USERPROFILE%\.gemini\config\plugins\agentic-senior-core"
+```
 
-# Or manually copy the plugin bundle to:
-# ~/.gemini/config/plugins/agentic-senior-core/
+```bash
+# macOS / Linux
+cp -r "$(npm root -g)/@ryuenn3123/agentic-senior-core/.agents/plugins/agentic-senior-core" ~/.gemini/config/plugins/
 ```
 
 The plugin bundle includes rules, skills (`/asc-review`, `/asc-audit`, `/asc-refactor`), and `plugin.json`.
 
 </details>
 
+<details>
+<summary><b>Google Antigravity CLI</b></summary>
+
+Requires [Antigravity CLI](https://antigravity.google) (`agy`) installed separately.
+
+```bash
+agy plugin install https://github.com/fatidaprilian/Agentic-Senior-Core.git
+```
+
+</details>
+
 <details>
 <summary><b>Devin / Hermes / OpenCode / OpenClaw</b></summary>
 
@@ -153,12 +258,12 @@ Plugin manifests ship in the npm package at their standard paths (`.devin-plugin
 asc adapter --all
 ```
 
-Generates adapter files for Cursor, Windsurf, Cline, Copilot, and Kiro in one go.
+Generates adapter files for Cursor, Devin Desktop, Windsurf, Cline, Copilot, Kiro, Continue, Zed, Aider, Kilo Code, Roo Code, and OpenHands in one go.
 
 </details>
 
 **Terminal agents** (Claude Code, Codex, Gemini, Copilot CLI) = install once, always-on, zero per-project files.
-**IDE agents** (Cursor, Windsurf, Cline, Copilot VS Code, Kiro, Antigravity) = one file per project via `asc adapter` or copy.
+**IDE agents** (Cursor, Devin Desktop, Cline, Copilot VS Code, Kiro, Continue, Zed, Aider, Kilo Code, Roo Code, OpenHands, Antigravity) = one file per project via `asc adapter` or copy.
 
 ### Updating
 
@@ -205,12 +310,20 @@ Input validation at trust boundaries, parameterized queries, auth checks, error
 | Hermes | Terminal agent | Plugin registration | No |
 | OpenCode | Terminal agent | Auto-detected | No |
 | OpenClaw | Terminal agent | Auto-detected | No |
-| Antigravity | IDE | `agy plugin install` or copy rules | No (plugin) / Yes (rules) |
+| Antigravity IDE | IDE | Copy rules or plugin bundle | No (global) / Yes (rules) |
+| Antigravity CLI | Terminal agent | `agy plugin install` | No |
 | Cursor | IDE | `asc adapter --cursor` | Yes (1 file) |
-| Windsurf | IDE | `asc adapter --windsurf` | Yes (1 file) |
+| Devin Desktop | IDE | `asc adapter --devin` | Yes (1 file) |
+| Windsurf (legacy) | IDE | `asc adapter --windsurf` | Yes (1 file) |
 | Cline | VS Code ext | `asc adapter --cline` | Yes (1 file) |
 | GitHub Copilot | VS Code ext | `asc adapter --copilot` | Yes (1 file) |
 | Kiro | IDE | `asc adapter --kiro` | Yes (1 file) |
+| Continue | VS Code ext | `asc adapter --continue` | Yes (1 file) |
+| Zed | IDE | `asc adapter --zed` | Yes (1 file) |
+| Aider | Terminal agent | `asc adapter --aider` | Yes (1 file) |
+| Kilo Code | VS Code ext | `asc adapter --kilocode` | Yes (1 file) |
+| Roo Code | VS Code ext | `asc adapter --roo` | Yes (1 file) |
+| OpenHands | Agent | `asc adapter --openhands` | Yes (1 file) |
 
 ---
 
@@ -230,7 +343,8 @@ Available on plugin hosts (Claude Code, Codex, Gemini CLI):
 ## CLI
 
 ```bash
-asc adapter [--cursor|--windsurf|--cline|--copilot|--kiro|--all]
+asc adapter [--cursor|--devin|--windsurf|--cline|--copilot|--kiro|--continue|--zed|--aider|--kilocode|--roo|--openhands|--all]
+asc uninstall [--dry-run]
 asc clean [--dry-run]
 asc status
 asc mcp

package/bin/agentic-senior-core.js

@@ -3,10 +3,11 @@
  * Agentic-Senior-Core CLI v5 -- Universal plugin system.
  *
  * Commands:
- *   adapter   Generate instruction-tier adapter files for IDEs without plugin support
- *   clean     Remove v4 per-project artifacts (.agent-context/, bridge files)
- *   status    Show detected IDEs and install hints
- *   mcp       Start MCP stdio server
+ *   adapter     Generate instruction-tier adapter files for IDEs without plugin support
+ *   uninstall   Remove ASC adapter files from the current project
+ *   clean       Remove v4 per-project artifacts (.agent-context/, bridge files)
+ *   status      Show detected IDEs and install hints
+ *   mcp         Start MCP stdio server
  */
 import { exit } from 'node:process';
 import { readFileSync } from 'node:fs';
@@ -25,9 +26,10 @@ function printUsage() {
   console.log('  Claude Code:  /plugin marketplace add fatidaprilian/Agentic-Senior-Core');
   console.log('  Codex CLI:    codex plugins install agentic-senior-core\n');
   console.log('Adapter install (one file per project):');
-  console.log('  asc adapter --cursor --windsurf --cline --copilot --kiro --all\n');
+  console.log('  asc adapter --cursor --devin --cline --copilot --kiro --continue --zed --aider --kilocode --roo --openhands --windsurf --all\n');
   console.log('Commands:');
   console.log('  adapter       Generate instruction-tier adapter files');
+  console.log('  uninstall     Remove ASC adapter files from this project');
   console.log('  clean         Remove v4 per-project artifacts');
   console.log('  status        Show detected IDEs and install hints');
   console.log('  mcp           Start MCP stdio server');
@@ -55,6 +57,12 @@ async function main() {
     return;
   }
 
+  if (commandArgument === 'uninstall') {
+    const { runUninstallCommand } = await import('../lib/cli/commands/uninstall.mjs');
+    await runUninstallCommand(commandArguments);
+    return;
+  }
+
   if (commandArgument === 'clean') {
     const { runCleanCommand } = await import('../lib/cli/commands/clean.mjs');
     await runCleanCommand(commandArguments);

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-senior-core",
-  "version": "5.2.0",
+  "version": "5.4.0",
   "description": "Universal AI coding rules. Write code like a staff engineer.",
   "author": "fatidaprilian",
   "license": "MIT",

package/lib/cli/commands/adapter.mjs

@@ -13,10 +13,15 @@ const ADAPTER_TARGETS = {
     sourcePath: '.cursor/rules/agentic-senior-core.mdc',
   },
   windsurf: {
-    label: 'Windsurf',
+    label: 'Windsurf (legacy)',
     targetPath: '.windsurf/rules/agentic-senior-core.md',
     sourcePath: '.windsurf/rules/agentic-senior-core.md',
   },
+  devin: {
+    label: 'Devin Desktop',
+    targetPath: '.devin/rules/agentic-senior-core.md',
+    sourcePath: '.devin/rules/agentic-senior-core.md',
+  },
   cline: {
     label: 'Cline',
     targetPath: '.clinerules/agentic-senior-core.md',
@@ -32,6 +37,36 @@ const ADAPTER_TARGETS = {
     targetPath: '.kiro/steering/agentic-senior-core.md',
     sourcePath: '.kiro/steering/agentic-senior-core.md',
   },
+  continue: {
+    label: 'Continue',
+    targetPath: '.continue/rules/agentic-senior-core.md',
+    sourcePath: '.continue/rules/agentic-senior-core.md',
+  },
+  zed: {
+    label: 'Zed',
+    targetPath: '.zed/rules/agentic-senior-core.md',
+    sourcePath: '.zed/rules/agentic-senior-core.md',
+  },
+  aider: {
+    label: 'Aider',
+    targetPath: 'CONVENTIONS.md',
+    sourcePath: 'CONVENTIONS.md',
+  },
+  kilocode: {
+    label: 'Kilo Code',
+    targetPath: '.kilocode/rules/agentic-senior-core.md',
+    sourcePath: '.kilocode/rules/agentic-senior-core.md',
+  },
+  roo: {
+    label: 'Roo Code',
+    targetPath: '.roo/rules/agentic-senior-core.md',
+    sourcePath: '.roo/rules/agentic-senior-core.md',
+  },
+  openhands: {
+    label: 'OpenHands',
+    targetPath: '.openhands/microagents/agentic-senior-core.md',
+    sourcePath: '.openhands/microagents/agentic-senior-core.md',
+  },
 };
 
 async function pathExists(filePath) {
@@ -87,7 +122,7 @@ export async function runAdapterCommand(commandArguments) {
 
   if (requestedAdapters.length === 0) {
     console.log('Agentic Senior Core -- Adapter Generator\n');
-    console.log('Usage: asc adapter [--cursor] [--windsurf] [--cline] [--copilot] [--kiro] [--all]\n');
+    console.log('Usage: asc adapter [--cursor] [--devin] [--cline] [--copilot] [--kiro] [--continue] [--zed] [--aider] [--kilocode] [--roo] [--openhands] [--windsurf] [--all]\n');
     console.log('Generates instruction-tier adapter files for IDEs without plugin support.');
     console.log('Each adapter is a single file containing the universal coding rules.\n');
     console.log('Available adapters:');

package/lib/cli/commands/status.mjs

@@ -1,62 +1,131 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import os from 'node:os';
+import { execSync } from 'node:child_process';
 
 const HOME = os.homedir();
+const IS_WIN = process.platform === 'win32';
+const IS_MAC = process.platform === 'darwin';
+
+function commandExists(name) {
+  try {
+    execSync(IS_WIN ? `where ${name}` : `which ${name}`, { stdio: 'ignore' });
+    return true;
+  } catch {
+    return false;
+  }
+}
 
 const IDE_CHECKS = [
   {
     name: 'Claude Code',
     type: 'plugin',
-    checkPaths: [
-      path.join(HOME, '.claude'),
-    ],
-    installHint: '/plugin marketplace add fatidaprilian/Agentic-Senior-Core',
+    checkPaths: [path.join(HOME, '.claude')],
+    installHint: 'claude plugin add fatidaprilian/Agentic-Senior-Core',
   },
   {
     name: 'Codex CLI',
     type: 'plugin',
-    checkPaths: [
-      path.join(HOME, '.codex'),
-    ],
+    checkPaths: [path.join(HOME, '.codex')],
     installHint: 'codex plugins install agentic-senior-core',
   },
   {
     name: 'Gemini CLI',
     type: 'plugin',
-    checkPaths: [
-      path.join(HOME, '.gemini'),
-    ],
+    checkPaths: [path.join(HOME, '.gemini')],
     installHint: 'Auto-detected via gemini-extension.json',
   },
+  {
+    name: 'Antigravity',
+    type: 'plugin',
+    checkPaths: [path.join(HOME, '.gemini')],
+    checkCommands: ['agy'],
+    installHint: 'agy plugin install https://github.com/fatidaprilian/Agentic-Senior-Core.git',
+  },
   {
     name: 'Cursor',
     type: 'adapter',
     checkPaths: [
       path.join(HOME, '.cursor'),
-      path.join(HOME, 'AppData', 'Roaming', 'Cursor'),
-      path.join(HOME, '.config', 'Cursor'),
+      ...(IS_WIN ? [path.join(HOME, 'AppData', 'Roaming', 'Cursor')] : []),
+      ...(!IS_WIN ? [path.join(HOME, '.config', 'Cursor')] : []),
     ],
     installHint: 'asc adapter --cursor',
   },
   {
-    name: 'Windsurf',
+    name: 'Devin Desktop',
     type: 'adapter',
     checkPaths: [
+      path.join(HOME, '.devin'),
       path.join(HOME, '.codeium'),
-      path.join(HOME, '.windsurf'),
+      ...(IS_WIN ? [path.join(HOME, 'AppData', 'Roaming', 'Windsurf')] : []),
     ],
-    installHint: 'asc adapter --windsurf',
+    installHint: 'asc adapter --devin',
   },
   {
     name: 'Cline',
     type: 'adapter',
     checkPaths: [
-      path.join(HOME, 'Documents', 'Cline'),
       path.join(HOME, '.cline'),
+      ...(IS_WIN ? [path.join(HOME, 'Documents', 'Cline')] : []),
     ],
     installHint: 'asc adapter --cline',
   },
+  {
+    name: 'GitHub Copilot',
+    type: 'adapter',
+    checkPaths: [
+      path.join(HOME, '.config', 'github-copilot'),
+      ...(IS_WIN ? [path.join(HOME, 'AppData', 'Local', 'GitHub Copilot')] : []),
+    ],
+    installHint: 'asc adapter --copilot',
+  },
+  {
+    name: 'Kiro',
+    type: 'adapter',
+    checkPaths: [path.join(HOME, '.kiro')],
+    installHint: 'asc adapter --kiro',
+  },
+  {
+    name: 'Continue',
+    type: 'adapter',
+    checkPaths: [path.join(HOME, '.continue')],
+    installHint: 'asc adapter --continue',
+  },
+  {
+    name: 'Zed',
+    type: 'adapter',
+    checkPaths: [
+      path.join(HOME, '.config', 'zed'),
+      ...(IS_MAC ? [path.join(HOME, 'Library', 'Application Support', 'Zed')] : []),
+    ],
+    installHint: 'asc adapter --zed',
+  },
+  {
+    name: 'Aider',
+    type: 'adapter',
+    checkPaths: [],
+    checkCommands: ['aider'],
+    installHint: 'asc adapter --aider',
+  },
+  {
+    name: 'Kilo Code',
+    type: 'adapter',
+    checkPaths: [path.join(HOME, '.kilocode')],
+    installHint: 'asc adapter --kilocode',
+  },
+  {
+    name: 'Roo Code',
+    type: 'adapter',
+    checkPaths: [path.join(HOME, '.roo')],
+    installHint: 'asc adapter --roo',
+  },
+  {
+    name: 'OpenHands',
+    type: 'adapter',
+    checkPaths: [path.join(HOME, '.openhands')],
+    installHint: 'asc adapter --openhands',
+  },
 ];
 
 async function pathExists(filePath) {
@@ -69,10 +138,11 @@ async function pathExists(filePath) {
 }
 
 export async function runStatusCommand() {
-  console.log('Agentic Senior Core -- IDE Status\n');
+  console.log('Agentic Senior Core -- Host Status\n');
 
   for (const ide of IDE_CHECKS) {
     let detected = false;
+
     for (const checkPath of ide.checkPaths) {
       if (await pathExists(checkPath)) {
         detected = true;
@@ -80,9 +150,18 @@ export async function runStatusCommand() {
       }
     }
 
+    if (!detected && ide.checkCommands) {
+      for (const cmd of ide.checkCommands) {
+        if (commandExists(cmd)) {
+          detected = true;
+          break;
+        }
+      }
+    }
+
     const icon = detected ? '[x]' : '[ ]';
     const support = ide.type === 'plugin' ? '(plugin)' : '(adapter)';
-    console.log(`  ${icon} ${ide.name.padEnd(15)} ${support.padEnd(10)} ${detected ? 'detected' : 'not found'}`);
+    console.log(`  ${icon} ${ide.name.padEnd(18)} ${support.padEnd(10)} ${detected ? 'detected' : 'not found'}`);
 
     if (detected) {
       console.log(`      Install: ${ide.installHint}`);
@@ -91,4 +170,5 @@ export async function runStatusCommand() {
 
   console.log('\nPlugin hosts get always-on rules via SessionStart hook.');
   console.log('Adapter hosts need one file per project via "asc adapter".');
+  console.log('\nTip: run "asc adapter --all" to generate adapters for all supported hosts.');
 }

package/lib/cli/commands/uninstall.mjs

@@ -0,0 +1,80 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+
+const ASC_SIGNATURE = '# Agentic Senior Core';
+
+const ADAPTER_FILES = [
+  { label: 'Cursor', path: '.cursor/rules/agentic-senior-core.mdc' },
+  { label: 'Windsurf (legacy)', path: '.windsurf/rules/agentic-senior-core.md' },
+  { label: 'Devin Desktop', path: '.devin/rules/agentic-senior-core.md' },
+  { label: 'Cline', path: '.clinerules/agentic-senior-core.md' },
+  { label: 'GitHub Copilot', path: '.github/copilot-instructions.md' },
+  { label: 'Kiro', path: '.kiro/steering/agentic-senior-core.md' },
+  { label: 'Continue', path: '.continue/rules/agentic-senior-core.md' },
+  { label: 'Zed', path: '.zed/rules/agentic-senior-core.md' },
+  { label: 'Aider', path: 'CONVENTIONS.md' },
+  { label: 'Kilo Code', path: '.kilocode/rules/agentic-senior-core.md' },
+  { label: 'Roo Code', path: '.roo/rules/agentic-senior-core.md' },
+  { label: 'OpenHands', path: '.openhands/microagents/agentic-senior-core.md' },
+];
+
+async function pathExists(filePath) {
+  try {
+    await fs.access(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+async function isAscFile(filePath) {
+  try {
+    const content = await fs.readFile(filePath, 'utf8');
+    return content.includes(ASC_SIGNATURE);
+  } catch {
+    return false;
+  }
+}
+
+export async function runUninstallCommand(commandArguments) {
+  const targetDirectory = process.cwd();
+  const dryRun = commandArguments.includes('--dry-run');
+
+  console.log('Agentic Senior Core -- Uninstall adapters\n');
+  console.log(`Target: ${targetDirectory}`);
+  if (dryRun) console.log('Mode: dry-run (no files will be deleted)\n');
+  else console.log('');
+
+  let found = 0;
+  let removed = 0;
+
+  for (const adapter of ADAPTER_FILES) {
+    const fullPath = path.join(targetDirectory, adapter.path);
+    if (!(await pathExists(fullPath))) continue;
+    if (!(await isAscFile(fullPath))) {
+      console.log(`  skip: ${adapter.path} (not an ASC file)`);
+      continue;
+    }
+
+    found++;
+
+    if (dryRun) {
+      console.log(`  would remove: ${adapter.path} (${adapter.label})`);
+    } else {
+      await fs.rm(fullPath);
+      console.log(`  removed: ${adapter.path} (${adapter.label})`);
+      removed++;
+    }
+  }
+
+  if (found === 0) {
+    console.log('No ASC adapter files found in this project.');
+    return;
+  }
+
+  if (dryRun) {
+    console.log(`\n${found} adapter file(s) found. Run without --dry-run to remove.`);
+  } else {
+    console.log(`\n${removed} adapter file(s) removed.`);
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ryuenn3123/agentic-senior-core",
-  "version": "5.2.0",
+  "version": "5.4.0",
   "type": "module",
   "description": "Universal AI coding rules. Write code like a staff engineer, not a junior.",
   "bin": {
@@ -12,6 +12,7 @@
     "bin/",
     "lib/cli/commands/adapter.mjs",
     "lib/cli/commands/clean.mjs",
+    "lib/cli/commands/uninstall.mjs",
     "lib/cli/commands/status.mjs",
     "lib/cli/commands/mcp.mjs",
     "lib/cli/ascx/",
@@ -25,8 +26,15 @@
     ".opencode/",
     ".cursor/rules/",
     ".windsurf/rules/",
+    ".devin/rules/",
     ".clinerules/",
     ".kiro/steering/",
+    ".continue/rules/",
+    ".zed/rules/",
+    ".kilocode/rules/",
+    ".roo/rules/",
+    ".openhands/microagents/",
+    "CONVENTIONS.md",
     "gemini-extension.json",
     "plugin.yaml",
     "__init__.py",
@@ -63,6 +71,13 @@
     "hermes",
     "opencode",
     "openclaw",
+    "zed",
+    "continue",
+    "aider",
+    "kilocode",
+    "roo-code",
+    "openhands",
+    "antigravity",
     "plugin",
     "universal",
     "clean-code",

package/skills/asc-adapter/SKILL.md

@@ -0,0 +1,37 @@
+# ASC Adapter
+
+Detect installed AI coding hosts and generate adapter files for the current project.
+
+## When to use
+
+Run this when setting up a new project or when a developer wants ASC rules active across all their AI coding tools.
+
+## Steps
+
+1. Run `asc status` to detect which AI coding hosts are installed on this system.
+2. Check which adapter files already exist in the current project directory.
+3. For any detected host that is missing an adapter, run `asc adapter --<host>` to generate it.
+4. Use `asc adapter --all` to generate adapters for all supported hosts at once.
+
+## Supported hosts
+
+Plugin hosts (always-on, no adapter needed): Claude Code, Codex CLI, Gemini CLI, Antigravity CLI, Copilot CLI, Devin CLI, Hermes, OpenCode, OpenClaw.
+
+Adapter hosts (one file per project): Cursor, Devin Desktop, Cline, GitHub Copilot, Kiro, Continue, Zed, Aider, Kilo Code, Roo Code, OpenHands.
+
+## Commands
+
+```bash
+asc status                # Show detected hosts
+asc adapter --all         # Generate all adapters
+asc adapter --cursor      # Generate for specific host
+asc uninstall             # Remove all ASC adapter files
+asc uninstall --dry-run   # Preview what would be removed
+```
+
+## Notes
+
+- Adapter files contain the ASC universal coding rules, compressed to fit within each host's size limits.
+- Cursor uses `.mdc` format with `alwaysApply: true` frontmatter.
+- Windsurf is now Devin Desktop. Use `--devin` for the preferred path, `--windsurf` for legacy.
+- Zed also reads `AGENTS.md` natively, so the adapter is optional.