fix: plugin discovery with recursive directory scanning (#25)

Signed-off-by: Yordis Prieto <yordis.prieto@gmail.com>

Author: yordis

README.md

@@ -1,10 +1,12 @@
 # aipm
 
-**A plugin manager for AI coding assistants.**
+**A Cursor plugin manager with Claude Code marketplace federation.**
 
-Install plugins once, use them everywhere. Manage curated plugin collections across Claude Code, Cursor, and other AI assistants from multiple marketplace sources.
+Manage Cursor plugins from multiple sources including AIPM marketplaces and **auto-discovered Claude Code marketplaces**. Install plugins to Cursor from Claude Code's ecosystem without manual configuration.
 
-Inspired by [Claude Code's plugin marketplace system](https://docs.claude.com/en/docs/claude-code/plugin-marketplaces), extended to work across multiple AI assistants.
+**Simple model**: AIPM manages Cursor's `.cursor/` directory and can read from Claude Code's `.claude/` marketplaces for plugin discovery.
+
+Inspired by [Claude Code's plugin marketplace system](https://docs.claude.com/en/docs/claude-code/plugin-marketplaces), extended with marketplace federation and nested plugin structure support.
 
 ## Quick Start
 
@@ -15,12 +17,37 @@ mise use -g ubi:TrogonStack/aipm
 # Or download pre-built binary for your platform
 # See INSTALLATION.md for platform-specific download commands
 
-# Use
+# Initialize (auto-detects Cursor or Claude Code)
 aipm init
+
+# Add a marketplace
 aipm marketplace add team https://github.com/your-org/plugins.git
+
+# Install plugins (works with nested structures)
 aipm plugin install my-plugin@team
+aipm plugin install document-skills/docx@anthropic  # nested plugin support
 ```
 
+### Claude Code Marketplace Federation
+
+If you have Claude Code installed, **AIPM automatically discovers its marketplaces**:
+
+```bash
+# AIPM scans ~/.claude/plugins/known_marketplaces.json automatically
+aipm list
+
+📦 Marketplaces:
+  • claude:anthropic-agent-skills (🤖 Claude Code auto-discovered)
+  • claude:claude-code-workflows (🤖 Claude Code auto-discovered)
+
+# Install Claude Code plugins to Cursor
+aipm plugin install algorithmic-art@claude:anthropic-agent-skills
+aipm plugin install document-skills/docx@claude:anthropic-agent-skills
+aipm sync  # Installs to .cursor/ for Cursor to use
+```
+
+**Federation Model**: AIPM reads from Claude Code's marketplaces but installs everything to `.cursor/` (for Cursor). This gives you access to Claude Code's plugin ecosystem in Cursor without manual configuration.
+
 ## Documentation
 
 **See [docs/](./docs/) for complete documentation.**

docs/tutorials/getting-started.md

@@ -1,11 +1,12 @@
 # Getting Started with aipm
 
-A hands-on tutorial to get you started with aipm in 15 minutes.
+A hands-on tutorial to get you started with aipm in 15 minutes. Works with both **Cursor** and **Claude Code**!
 
 ## Prerequisites
 
 - `aipm` installed ([Installation Guide](../../INSTALLATION.md))
 - A project directory (we'll create one for testing)
+- Either Cursor or Claude Code (aipm auto-detects which one you're using)
 
 ## Part 1: Verify Installation
 
@@ -21,6 +22,8 @@ aipm --help
 
 Expected output: Version number (e.g., `0.1.0`)
 
+> **Note for Claude Code users**: AIPM is a Cursor plugin manager. It can discover and install plugins from Claude Code's marketplaces, but always installs them to Cursor's `.cursor/` directory. See the "Working with Claude Code's Official Marketplaces" section below.
+
 ## Part 2: Create Your First Plugin
 
 Let's create a test project and add a simple plugin:
@@ -153,6 +156,34 @@ When you run `aipm list`, you should see:
   ✓ hello-world@my-marketplace
 ```
 
+## Working with Claude Code's Official Marketplaces
+
+If you have Claude Code installed with official Anthropic marketplaces, **AIPM automatically discovers them**:
+
+```bash
+# No configuration needed - Claude Code marketplaces are auto-discovered!
+aipm list
+# Shows: claude:anthropic-agent-skills (auto-discovered from Claude Code)
+
+# Install Claude Code plugins to Cursor
+aipm plugin install algorithmic-art@claude:anthropic-agent-skills
+aipm plugin install document-skills/docx@claude:anthropic-agent-skills  # nested plugin!
+
+# Sync to .cursor/ directory (for Cursor to use)
+aipm sync
+
+# View all available plugins from both AIPM and Claude Code
+aipm plugin search
+```
+
+**How it works**:
+
+- AIPM reads `~/.claude/plugins/known_marketplaces.json` to discover Claude Code's marketplaces
+- Plugins are installed to `.cursor/` (AIPM never modifies `.claude/`)
+- You get the best of both worlds: Claude Code's marketplaces work in Cursor!
+
+**Nested Plugin Structure**: Claude Code's marketplaces use nested directories (like `document-skills/docx/`). AIPM automatically discovers all plugins regardless of nesting depth.
+
 ## Next Steps
 
 Congratulations! You've successfully:

src/commands/list.ts

@@ -32,8 +32,11 @@ export async function list(options: ListOptions = {}): Promise<void> {
     if (marketplaceCount > 0) {
       console.log('\n📦 Marketplaces:');
       for (const [name, marketplace] of Object.entries(config.marketplaces)) {
+        const isClaudeMarketplace = name.startsWith('claude:');
+        const sourceLabel = isClaudeMarketplace ? '🤖 Claude Code (auto-discovered)' : marketplace.source;
+
         console.log(`  • ${name}`);
-        console.log(`    Source: ${marketplace.source}`);
+        console.log(`    Source: ${sourceLabel}`);
 
         if (marketplace.source === 'directory' && marketplace.path) {
           console.log(`    Path: ${marketplace.path}`);

src/commands/plugin-install.ts

@@ -1,6 +1,7 @@
 import { join } from 'node:path';
 import { z } from 'zod';
 import { getConfigPaths, loadPluginsConfig } from '../config/loader';
+import { DIR_CURSOR } from '../constants';
 import { fileExists, writeJsonFile } from '../helpers/fs';
 import { resolveMarketplacePath } from '../helpers/git';
 import { defaultIO } from '../helpers/io';
@@ -119,7 +120,7 @@ export async function pluginInstall(options: unknown): Promise<void> {
     await writeJsonFile(targetPath, updatedConfig, PluginsConfigSchema);
     defaultIO.logSuccess(`Enabled plugin '${cmd.pluginId}' in ${configName}`);
 
-    const cursorDir = join(cwd, '.cursor');
+    const cursorDir = join(cwd, DIR_CURSOR);
     const syncResult = await syncPluginToCursor(pluginPath, marketplaceName, pluginName, cursorDir);
     const summary = formatSyncResult(syncResult);
 

src/commands/plugin-uninstall.ts

@@ -2,6 +2,7 @@ import { rm } from 'node:fs/promises';
 import { join } from 'node:path';
 import { z } from 'zod';
 import { getConfigPaths, loadPluginsConfig } from '../config/loader';
+import { DIR_CURSOR, DIR_MARKETPLACE } from '../constants';
 import { fileExists, writeJsonFile } from '../helpers/fs';
 import { defaultIO } from '../helpers/io';
 import { PluginsConfigSchema } from '../schema';
@@ -53,7 +54,7 @@ export async function pluginUninstall(options: unknown): Promise<void> {
     if (cmd.dryRun) {
       defaultIO.logInfo(`[DRY RUN] Would remove plugin '${cmd.pluginId}' from ${configName}`);
       if (cmd.removeFiles) {
-        defaultIO.logInfo(`[DRY RUN] Would delete files from .cursor/marketplace/`);
+        defaultIO.logInfo('[DRY RUN] Would delete files from .cursor/marketplace/');
       }
     } else {
       await writeJsonFile(targetPath, updatedConfig, PluginsConfigSchema);
@@ -63,7 +64,7 @@ export async function pluginUninstall(options: unknown): Promise<void> {
         const [pluginName, marketplaceName] = cmd.pluginId.split('@');
 
         if (pluginName && marketplaceName) {
-          const installedPath = join(cwd, '.cursor', 'marketplace', marketplaceName, pluginName);
+          const installedPath = join(cwd, DIR_CURSOR, DIR_MARKETPLACE, marketplaceName, pluginName);
 
           if (await fileExists(installedPath)) {
             await rm(installedPath, { recursive: true, force: true });

src/commands/plugin-update.ts

@@ -1,6 +1,7 @@
 import { join } from 'node:path';
 import { z } from 'zod';
 import { getConfigPaths, loadPluginsConfig } from '../config/loader';
+import { DIR_CURSOR } from '../constants';
 import { fileExists } from '../helpers/fs';
 import { resolveMarketplacePath } from '../helpers/git';
 import { defaultIO } from '../helpers/io';
@@ -98,7 +99,7 @@ export async function pluginUpdate(options: unknown): Promise<void> {
       return;
     }
 
-    const cursorDir = join(cwd, '.cursor');
+    const cursorDir = join(cwd, DIR_CURSOR);
     const syncResult = await syncPluginToCursor(pluginPath, marketplaceName, pluginName, cursorDir);
     const summary = formatSyncResult(syncResult);
 

src/commands/sync.ts

@@ -2,6 +2,7 @@ import { rm, stat } from 'node:fs/promises';
 import { join } from 'node:path';
 import { z } from 'zod';
 import { getConfigPaths, loadPluginsConfig } from '../config/loader';
+import { DIR_CURSOR, DIR_MARKETPLACE } from '../constants';
 import { ensureDir, fileExists } from '../helpers/fs';
 import { resolveMarketplacePath } from '../helpers/git';
 import { defaultIO } from '../helpers/io';
@@ -20,6 +21,7 @@ export async function sync(options: SyncOptions = {}): Promise<void> {
 
   const cwd = cmd.cwd || process.cwd();
   const paths = getConfigPaths(cwd);
+  const cursorDir = join(cwd, DIR_CURSOR);
 
   try {
     if (!(await fileExists(paths.plugins))) {
@@ -44,11 +46,9 @@ export async function sync(options: SyncOptions = {}): Promise<void> {
 
     console.log(`\n🔄 Syncing ${enabledPlugins.length} enabled plugin(s)...\n`);
 
-    const cursorDir = join(cwd, '.cursor');
-
     if (!cmd.dryRun) {
       // Clean up old marketplace directory if it exists
-      const oldMarketplaceDir = join(cursorDir, 'marketplace');
+      const oldMarketplaceDir = join(cursorDir, DIR_MARKETPLACE);
       if (await fileExists(oldMarketplaceDir)) {
         await rm(oldMarketplaceDir, { recursive: true, force: true });
       }

src/config/loader.ts

@@ -7,6 +7,11 @@ import {
   FILE_PLUGINS_EXAMPLE,
   FILE_PLUGINS_LOCAL,
 } from '../constants';
+import {
+  convertClaudeMarketplaceToAIPM,
+  isClaudeCodeInstalled,
+  readClaudeCodeMarketplaces,
+} from '../helpers/claude-code-config';
 import { fileExists } from '../helpers/fs';
 import { getGlobalDir } from '../helpers/paths';
 import type { PluginsConfig } from '../schema';
@@ -76,11 +81,30 @@ export async function loadPluginsConfig(baseDir: string): Promise<PluginsConfig
 
     const { marketplaces: localMarketplaces, plugins: localPlugins } = await loadOptionalConfig(localConfigPath);
 
+    const claudeMarketplaces: Record<string, ReturnType<typeof convertClaudeMarketplaceToAIPM>> = {};
+    if (await isClaudeCodeInstalled()) {
+      const claudeCodeMarketplaces = await readClaudeCodeMarketplaces();
+
+      for (const marketplace of claudeCodeMarketplaces) {
+        const prefixedName = `claude:${marketplace.name}`;
+
+        if (globalMarketplaces[prefixedName] || config.marketplaces[prefixedName] || localMarketplaces[prefixedName]) {
+          console.warn(
+            `⚠️  Skipping Claude Code marketplace '${prefixedName}' - name conflict with existing AIPM marketplace`,
+          );
+          continue;
+        }
+
+        claudeMarketplaces[prefixedName] = convertClaudeMarketplaceToAIPM(marketplace);
+      }
+    }
+
     return {
       marketplaces: {
         ...globalMarketplaces,
         ...config.marketplaces,
         ...localMarketplaces,
+        ...claudeMarketplaces,
       },
       plugins: {
         ...globalPlugins,

src/constants.ts

@@ -2,6 +2,7 @@
  * File and directory names
  */
 export const DIR_CURSOR = '.cursor';
+export const DIR_CLAUDE = '.claude';
 export const DIR_CLAUDE_PLUGIN = '.claude-plugin';
 export const DIR_MARKETPLACE = 'marketplace';
 export const DIR_CACHE = 'cache';
@@ -17,6 +18,13 @@ export const FILE_MARKETPLACE_MANIFEST = 'marketplace.json';
 export const FILE_PLUGIN_MANIFEST = 'plugin.json';
 export const FILE_GITIGNORE = '.gitignore';
 
+/**
+ * Claude Code file names
+ */
+export const FILE_CLAUDE_KNOWN_MARKETPLACES = 'known_marketplaces.json';
+export const FILE_CLAUDE_INSTALLED_PLUGINS = 'installed_plugins.json';
+export const FILE_CLAUDE_CONFIG = 'config.json';
+
 /**
  * Environment variables
  */