@plosson/agentio 0.1.25 → 0.1.27

package/README.md

@@ -72,6 +72,7 @@ Download from [GitHub Releases](https://github.com/plosson/agentio/releases/late
 | Google Chat | Available | `send`, `list`, `get` |
 | Slack | Available | `send` |
 | JIRA | Available | `projects`, `search`, `get`, `comment`, `transitions`, `transition` |
+| RSS | Available | `articles`, `get`, `info` |
 | Linear | Planned | - |
 
 ## Usage
@@ -177,6 +178,23 @@ agentio jira transitions PROJ-123
 agentio jira transition PROJ-123 <transition-id>
 ```
 
+### RSS
+
+```bash
+# List articles from a blog (feed URL auto-discovered)
+agentio rss articles https://simonwillison.net
+agentio rss articles https://steipete.me --limit 5
+
+# Filter by date
+agentio rss articles https://blog.fsck.com --since 2025-01-01
+
+# Get feed info (shows discovered feed URL)
+agentio rss info https://kau.sh
+
+# Get a specific article
+agentio rss get https://simonwillison.net <article-url>
+```
+
 ## Multi-Profile Support
 
 Each service supports multiple named profiles:
@@ -192,54 +210,52 @@ agentio gmail list --profile work
 
 ## Claude Code Integration
 
-agentio provides plugins for [Claude Code](https://claude.ai/download) with skills for Gmail, Telegram, and Google Chat operations.
+agentio provides plugins for [Claude Code](https://claude.ai/download) with skills for Gmail, Telegram, Google Chat, JIRA, and RSS operations.
 
-### Install the Plugin
+### Install Marketplaces and Plugins
 
 ```bash
-# Install from GitHub
-agentio claude plugin install plosson/agentio
+# Add a marketplace (auto-detected from URL)
+agentio claude install https://github.com/plosson/agentio
 
-# Or install from a full GitHub URL
-agentio claude plugin install https://github.com/plosson/agentio
+# Install a plugin (auto-detected from name@marketplace format)
+agentio claude install agentio-gmail@agentio
 
-# Install to a specific directory
-agentio claude plugin install plosson/agentio -d ~/myproject
-
-# Install only specific components (skills, commands, hooks, agents)
-agentio claude plugin install plosson/agentio --skills
-agentio claude plugin install plosson/agentio --agents
-
-# Force reinstall if already exists
-agentio claude plugin install plosson/agentio -f
-
-# Show detailed installation logs
-agentio claude plugin install plosson/agentio --verbose
+# Install all from agentio.json
+agentio claude install
 ```
 
-Once installed, Claude Code can use the agentio CLI skills to help you manage emails, send Telegram messages, and more.
-
 ### Manage Plugins
 
 ```bash
-# List installed plugins
-agentio claude plugin list
+# List marketplaces and plugins from agentio.json
+agentio claude list
 
-# Remove a plugin
-agentio claude plugin remove agentio
+# Update marketplaces
+agentio claude update
+agentio claude update https://github.com/plosson/agentio
+
+# Remove a marketplace or plugin
+agentio claude remove https://github.com/plosson/agentio
+agentio claude remove agentio-gmail@agentio
 ```
 
-### Install from agentio.json
+### agentio.json
 
-If your project has an `agentio.json` file listing plugins, you can install all of them at once:
+Projects can define marketplaces and plugins in an `agentio.json` file:
 
-```bash
-# Install all plugins from agentio.json in current directory
-agentio claude plugin install
+```json
+{
+  "marketplaces": [
+    "https://github.com/plosson/agentio"
+  ],
+  "plugins": [
+    "agentio-gmail@agentio",
+    "agentio-rss@agentio"
+  ]
+}
 ```
 
-Plugins are installed to `.claude/` in the target directory (skills, commands, hooks, and agents subdirectories).
-
 ## Design
 
 agentio is designed for LLM consumption:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plosson/agentio",
-  "version": "0.1.25",
+  "version": "0.1.27",
   "description": "CLI for LLM agents to interact with communication and tracking services",
   "type": "module",
   "license": "MIT",

package/src/commands/claude.ts

@@ -10,6 +10,15 @@ import {
   removePlugin,
 } from '../services/claude-plugin/agentio-json';
 
+/**
+ * Determine if the argument is a marketplace URL or a plugin name.
+ * - URL (contains :// or github.com/) -> marketplace
+ * - Contains @ (e.g., plugin@marketplace) -> plugin
+ */
+function isMarketplaceUrl(arg: string): boolean {
+  return arg.includes('://') || arg.startsWith('github.com/');
+}
+
 /**
  * Execute a claude CLI command and return the result.
  */
@@ -90,6 +99,82 @@ async function installPluginCmd(name: string): Promise<boolean> {
   return false;
 }
 
+/**
+ * Get list of installed marketplaces with their names and sources.
+ */
+async function getMarketplaces(): Promise<Array<{ name: string; source: string }>> {
+  const result = await execClaude(['plugin', 'marketplace', 'list']);
+  if (!result.success) {
+    return [];
+  }
+
+  const marketplaces: Array<{ name: string; source: string }> = [];
+  const lines = result.stdout.split('\n');
+
+  let currentName: string | null = null;
+  for (const line of lines) {
+    // Match marketplace name: "  ❯ marketplace-name"
+    const nameMatch = line.match(/^\s*❯\s+(.+)$/);
+    if (nameMatch) {
+      currentName = nameMatch[1].trim();
+      continue;
+    }
+
+    // Match source line: "    Source: GitHub (user/repo)" or "    Source: Git (url)"
+    const sourceMatch = line.match(/^\s*Source:\s*(?:GitHub|Git)\s*\((.+)\)$/);
+    if (sourceMatch && currentName) {
+      marketplaces.push({ name: currentName, source: sourceMatch[1].trim() });
+      currentName = null;
+    }
+  }
+
+  return marketplaces;
+}
+
+/**
+ * Find marketplace name by URL.
+ */
+async function findMarketplaceName(url: string): Promise<string | null> {
+  const marketplaces = await getMarketplaces();
+
+  // Normalize the URL for comparison
+  const normalizedUrl = url
+    .replace(/^https?:\/\//, '')
+    .replace(/^github\.com\//, '')
+    .replace(/\.git$/, '')
+    .toLowerCase();
+
+  for (const mp of marketplaces) {
+    const normalizedSource = mp.source
+      .replace(/^https?:\/\//, '')
+      .replace(/^github\.com\//, '')
+      .replace(/\.git$/, '')
+      .toLowerCase();
+
+    if (normalizedSource === normalizedUrl || normalizedSource.includes(normalizedUrl) || normalizedUrl.includes(normalizedSource)) {
+      return mp.name;
+    }
+  }
+
+  return null;
+}
+
+/**
+ * Update a marketplace by name.
+ */
+async function updateMarketplace(name: string): Promise<boolean> {
+  console.error(`Updating marketplace: ${name}`);
+  const result = await execClaude(['plugin', 'marketplace', 'update', name]);
+
+  if (result.success) {
+    console.log(`  Updated: ${name}`);
+    return true;
+  }
+
+  console.error(`  Failed: ${result.stderr.trim()}`);
+  return false;
+}
+
 /**
  * Uninstall a plugin by calling claude plugin uninstall --scope project.
  */
@@ -118,79 +203,71 @@ export function registerClaudeCommands(program: Command): void {
     .command('claude')
     .description('Claude Code plugin operations');
 
-  // install command group
-  const install = claude.command('install').description('Install marketplaces and plugins');
-
-  install
-    .command('marketplace')
-    .description('Add a plugin marketplace')
-    .argument('<url>', 'Marketplace GitHub URL')
+  // install command - auto-detects marketplace vs plugin
+  claude
+    .command('install')
+    .description('Install a marketplace (URL) or plugin (name@marketplace), or all from agentio.json')
+    .argument('[target]', 'Marketplace URL or plugin name (e.g., plugin@marketplace)')
     .option('-d, --dir <path>', 'Directory with agentio.json (default: current directory)')
-    .action(async (url, options) => {
+    .action(async (target, options) => {
       try {
         const targetDir = options.dir ? path.resolve(options.dir) : process.cwd();
 
-        const success = await installMarketplace(url);
-        if (success) {
-          addMarketplace(targetDir, url);
-        }
-      } catch (error) {
-        handleError(error);
-      }
-    });
-
-  install
-    .command('plugin')
-    .description('Install a plugin')
-    .argument('<name>', 'Plugin name (e.g., plugin-name@marketplace)')
-    .option('-d, --dir <path>', 'Directory with agentio.json (default: current directory)')
-    .action(async (name, options) => {
-      try {
-        const targetDir = options.dir ? path.resolve(options.dir) : process.cwd();
+        // No argument - install all from agentio.json
+        if (!target) {
+          const config = loadAgentioJson(targetDir);
 
-        const success = await installPluginCmd(name);
-        if (success) {
-          addPlugin(targetDir, name);
-        }
-      } catch (error) {
-        handleError(error);
-      }
-    });
+          if (config.marketplaces.length === 0 && config.plugins.length === 0) {
+            console.log('No marketplaces or plugins defined in agentio.json');
+            return;
+          }
 
-  // install with no subcommand - install all from agentio.json
-  install.action(async (options) => {
-    try {
-      const targetDir = options.dir ? path.resolve(options.dir) : process.cwd();
-      const config = loadAgentioJson(targetDir);
+          console.error(`Installing from agentio.json...`);
 
-      if (config.marketplaces.length === 0 && config.plugins.length === 0) {
-        console.log('No marketplaces or plugins defined in agentio.json');
-        return;
-      }
+          // Install marketplaces first
+          if (config.marketplaces.length > 0) {
+            console.error(`\nMarketplaces (${config.marketplaces.length}):`);
+            for (const url of config.marketplaces) {
+              await installMarketplace(url);
+            }
+          }
 
-      console.error(`Installing from agentio.json...`);
+          // Then install plugins
+          if (config.plugins.length > 0) {
+            console.error(`\nPlugins (${config.plugins.length}):`);
+            for (const name of config.plugins) {
+              await installPluginCmd(name);
+            }
+          }
 
-      // Install marketplaces first
-      if (config.marketplaces.length > 0) {
-        console.error(`\nMarketplaces (${config.marketplaces.length}):`);
-        for (const url of config.marketplaces) {
-          await installMarketplace(url);
+          console.log('\nDone.');
+          return;
         }
-      }
 
-      // Then install plugins
-      if (config.plugins.length > 0) {
-        console.error(`\nPlugins (${config.plugins.length}):`);
-        for (const name of config.plugins) {
-          await installPluginCmd(name);
+        // Auto-detect type based on argument format
+        if (isMarketplaceUrl(target)) {
+          // It's a marketplace URL
+          const success = await installMarketplace(target);
+          if (success) {
+            addMarketplace(targetDir, target);
+          }
+        } else if (target.includes('@')) {
+          // It's a plugin (contains @)
+          const success = await installPluginCmd(target);
+          if (success) {
+            addPlugin(targetDir, target);
+          }
+        } else {
+          throw new CliError(
+            'INVALID_PARAMS',
+            `Cannot determine type for: ${target}`,
+            'Use a URL for marketplaces or name@marketplace for plugins'
+          );
         }
+      } catch (error) {
+        handleError(error);
       }
-
-      console.log('\nDone.');
-    } catch (error) {
-      handleError(error);
-    }
-  });
+    });
 
   // list command
   claude
@@ -228,40 +305,80 @@ export function registerClaudeCommands(program: Command): void {
       }
     });
 
-  // remove command group
-  const remove = claude.command('remove').description('Remove marketplaces and plugins');
-
-  remove
-    .command('marketplace')
-    .description('Remove a marketplace from agentio.json')
-    .argument('<url>', 'Marketplace URL to remove')
+  // update command - updates marketplaces
+  claude
+    .command('update')
+    .description('Update marketplaces (all from agentio.json or a specific URL)')
+    .argument('[url]', 'Marketplace URL to update (updates all from agentio.json if not specified)')
     .option('-d, --dir <path>', 'Directory with agentio.json (default: current directory)')
     .action(async (url, options) => {
       try {
         const targetDir = options.dir ? path.resolve(options.dir) : process.cwd();
 
-        const removed = removeMarketplace(targetDir, url);
-        if (removed) {
-          console.log(`Removed marketplace: ${url}`);
+        if (url) {
+          // Update specific marketplace by URL
+          const name = await findMarketplaceName(url);
+          if (!name) {
+            throw new CliError('NOT_FOUND', `Marketplace not found for URL: ${url}`, 'Make sure the marketplace is installed');
+          }
+          await updateMarketplace(name);
         } else {
-          throw new CliError('NOT_FOUND', `Marketplace not found: ${url}`);
+          // Update all marketplaces from agentio.json
+          const config = loadAgentioJson(targetDir);
+
+          if (config.marketplaces.length === 0) {
+            console.log('No marketplaces defined in agentio.json');
+            return;
+          }
+
+          console.error(`Updating marketplaces from agentio.json...`);
+
+          for (const marketplaceUrl of config.marketplaces) {
+            const name = await findMarketplaceName(marketplaceUrl);
+            if (name) {
+              await updateMarketplace(name);
+            } else {
+              console.error(`  Skipped (not installed): ${marketplaceUrl}`);
+            }
+          }
+
+          console.log('\nDone.');
         }
       } catch (error) {
         handleError(error);
       }
     });
 
-  remove
-    .command('plugin')
-    .description('Uninstall a plugin and remove from agentio.json')
-    .argument('<name>', 'Plugin name to remove')
+  // remove command - auto-detects marketplace vs plugin
+  claude
+    .command('remove')
+    .description('Remove a marketplace (URL) or plugin (name@marketplace)')
+    .argument('<target>', 'Marketplace URL or plugin name to remove')
     .option('-d, --dir <path>', 'Directory with agentio.json (default: current directory)')
-    .action(async (name, options) => {
+    .action(async (target, options) => {
       try {
         const targetDir = options.dir ? path.resolve(options.dir) : process.cwd();
 
-        await uninstallPluginCmd(name);
-        removePlugin(targetDir, name);
+        // Auto-detect type based on argument format
+        if (isMarketplaceUrl(target)) {
+          // It's a marketplace URL
+          const removed = removeMarketplace(targetDir, target);
+          if (removed) {
+            console.log(`Removed marketplace: ${target}`);
+          } else {
+            throw new CliError('NOT_FOUND', `Marketplace not found: ${target}`);
+          }
+        } else if (target.includes('@')) {
+          // It's a plugin (contains @)
+          await uninstallPluginCmd(target);
+          removePlugin(targetDir, target);
+        } else {
+          throw new CliError(
+            'INVALID_PARAMS',
+            `Cannot determine type for: ${target}`,
+            'Use a URL for marketplaces or name@marketplace for plugins'
+          );
+        }
       } catch (error) {
         handleError(error);
       }