zuppaclaude 1.2.0 → 1.3.0

package/assets/commands/zc/help.md

@@ -46,6 +46,12 @@ Display ZuppaClaude commands and documentation.
 | `/zc:settings import` | Import settings |
 | `/zc:settings reset` | Reset to defaults |
 
+### Claude HUD
+
+| Command | Description |
+|---------|-------------|
+| `/zc:hud` | Claude HUD setup instructions |
+
 ## Quick Start
 
 ```

package/assets/commands/zc/hud.md

@@ -0,0 +1,45 @@
+---
+name: zc:hud
+description: "Claude HUD setup instructions"
+category: utility
+---
+
+# /zc:hud - Claude HUD Setup
+
+Display Claude HUD installation instructions.
+
+## What is Claude HUD?
+
+Claude HUD is a status display plugin that provides:
+- Real-time context usage meter
+- Active tool tracking
+- Running agent status
+- Todo progress display
+
+## Installation Steps
+
+Run these commands inside Claude Code:
+
+```
+1. /plugin marketplace add jarrodwatts/claude-hud
+2. /plugin install claude-hud
+3. /claude-hud:setup
+```
+
+## Requirements
+
+- Claude Code v1.0.80 or later
+- Plugin support enabled
+
+## CLI Alternative
+
+```bash
+setup-claude-hud
+```
+
+## Execution
+
+When this command is invoked:
+1. Show the Claude HUD information above
+2. Guide the user through the installation steps
+3. Explain that they need to run the plugin commands in Claude Code

package/lib/components/cloud.js

@@ -22,6 +22,95 @@ class CloudManager {
     return this.platform.commandExists('rclone');
   }
 
+  /**
+   * Install rclone
+   */
+  async installRclone() {
+    if (this.isRcloneInstalled()) {
+      this.logger.success('rclone is already installed');
+      return true;
+    }
+
+    this.logger.step('Installing rclone...');
+
+    try {
+      if (this.platform.isMac) {
+        // Check if brew is available
+        if (this.platform.commandExists('brew')) {
+          this.platform.exec('brew install rclone', { silent: false, stdio: 'inherit' });
+        } else {
+          this.logger.warning('Homebrew not found, using curl installer');
+          this.platform.exec('curl https://rclone.org/install.sh | sudo bash', { silent: false, stdio: 'inherit' });
+        }
+      } else if (this.platform.isLinux) {
+        // Try package managers in order
+        if (this.platform.commandExists('apt')) {
+          this.platform.exec('sudo apt update && sudo apt install -y rclone', { silent: false, stdio: 'inherit' });
+        } else if (this.platform.commandExists('dnf')) {
+          this.platform.exec('sudo dnf install -y rclone', { silent: false, stdio: 'inherit' });
+        } else if (this.platform.commandExists('pacman')) {
+          this.platform.exec('sudo pacman -S --noconfirm rclone', { silent: false, stdio: 'inherit' });
+        } else {
+          // Fallback to curl installer
+          this.platform.exec('curl https://rclone.org/install.sh | sudo bash', { silent: false, stdio: 'inherit' });
+        }
+      } else if (this.platform.isWindows) {
+        // Windows - try winget first
+        if (this.platform.commandExists('winget')) {
+          this.platform.exec('winget install -e --id Rclone.Rclone', { silent: false, stdio: 'inherit' });
+        } else if (this.platform.commandExists('choco')) {
+          this.platform.exec('choco install rclone -y', { silent: false, stdio: 'inherit' });
+        } else {
+          this.logger.error('Please install rclone manually: https://rclone.org/install/');
+          return false;
+        }
+      }
+
+      // Verify installation
+      if (this.isRcloneInstalled()) {
+        this.logger.success('rclone installed successfully');
+        return true;
+      } else {
+        this.logger.warning('rclone installation may require terminal restart');
+        return true;
+      }
+    } catch (error) {
+      this.logger.error(`Failed to install rclone: ${error.message}`);
+      this.logger.info('Install manually: https://rclone.org/install/');
+      return false;
+    }
+  }
+
+  /**
+   * Verify rclone installation
+   */
+  verify() {
+    if (this.isRcloneInstalled()) {
+      try {
+        const version = this.platform.exec('rclone version', { silent: true });
+        const versionMatch = version?.match(/rclone v([\d.]+)/);
+        if (versionMatch) {
+          this.logger.success(`rclone: v${versionMatch[1]}`);
+        } else {
+          this.logger.success('rclone: Installed');
+        }
+      } catch {
+        this.logger.success('rclone: Installed');
+      }
+
+      const remotes = this.getRemotes();
+      if (remotes.length > 0) {
+        this.logger.info(`Remotes: ${remotes.join(', ')}`);
+      } else {
+        this.logger.info('No remotes configured (run: rclone config)');
+      }
+      return true;
+    } else {
+      this.logger.warning('rclone: Not installed');
+      return false;
+    }
+  }
+
   /**
    * Get available rclone remotes
    */

package/lib/components/commands.js

@@ -53,7 +53,7 @@ class CommandsInstaller {
       }
 
       this.logger.success(`Installed ${installed} slash commands`);
-      this.logger.info('Commands available: /zc:backup, /zc:restore, /zc:cloud, /zc:session, /zc:settings, /zc:help');
+      this.logger.info('Commands available: /zc:backup, /zc:restore, /zc:cloud, /zc:session, /zc:settings, /zc:hud, /zc:help');
 
       return true;
     } catch (error) {
@@ -120,6 +120,7 @@ class CommandsInstaller {
       { cmd: '/zc:cloud', desc: 'Cloud backup management' },
       { cmd: '/zc:session', desc: 'Session management' },
       { cmd: '/zc:settings', desc: 'Settings management' },
+      { cmd: '/zc:hud', desc: 'Claude HUD setup instructions' },
       { cmd: '/zc:help', desc: 'Show help' }
     ];
 

package/lib/installer.js

@@ -12,7 +12,8 @@ const {
   ConfigInstaller,
   ClaudeZInstaller,
   ClaudeHUDInstaller,
-  CommandsInstaller
+  CommandsInstaller,
+  CloudManager
 } = require('./components');
 
 class Installer {
@@ -29,6 +30,7 @@ class Installer {
     this.claudeZ = new ClaudeZInstaller();
     this.claudeHUD = new ClaudeHUDInstaller();
     this.commands = new CommandsInstaller();
+    this.cloud = new CloudManager();
   }
 
   /**
@@ -38,7 +40,7 @@ class Installer {
     this.logger.banner();
 
     // Step 1: Check dependencies
-    this.logger.step('Step 1/8: Checking Dependencies');
+    this.logger.step('Step 1/9: Checking Dependencies');
     const depsOk = await this.checkDependencies();
     if (!depsOk) {
       this.logger.error('Dependency check failed. Please install required dependencies.');
@@ -112,12 +114,33 @@ class Installer {
       this.logger.info('Skipping Claude HUD installation');
     }
 
-    // Step 7: Install ZuppaClaude Commands
-    this.logger.step('Step 7/8: Installing ZuppaClaude Slash Commands');
+    // Step 7: Install rclone for cloud backup (optional)
+    this.logger.step('Step 7/9: Cloud Backup Setup (rclone)');
+    let installRclone = false;
+    let rcloneInstalled = this.cloud.isRcloneInstalled();
+
+    if (rcloneInstalled) {
+      this.logger.success('rclone is already installed');
+    } else {
+      if (useExisting && existingSettings.rclone !== undefined) {
+        installRclone = existingSettings.rclone;
+      } else {
+        installRclone = await this.prompts.confirm('Install rclone for cloud backup (Google Drive, Dropbox, S3)?', true);
+      }
+
+      if (installRclone) {
+        rcloneInstalled = await this.cloud.installRclone();
+      } else {
+        this.logger.info('Skipping rclone installation');
+      }
+    }
+
+    // Step 8: Install ZuppaClaude Commands
+    this.logger.step('Step 8/9: Installing ZuppaClaude Slash Commands');
     const cmdsInstalled = await this.commands.install();
 
-    // Step 8: Verification
-    this.logger.step('Step 8/8: Verifying Installation');
+    // Step 9: Verification
+    this.logger.step('Step 9/9: Verifying Installation');
     console.log('');
 
     this.superClaude.verify();
@@ -125,6 +148,7 @@ class Installer {
     this.config.verify();
     if (installClaudeZ) this.claudeZ.verify();
     if (installClaudeHUD) this.claudeHUD.verify();
+    this.cloud.verify();
     this.commands.verify();
 
     // Save settings
@@ -132,6 +156,7 @@ class Installer {
       specKit: installSpecKit,
       claudeZ: installClaudeZ,
       claudeHUD: installClaudeHUD,
+      rclone: rcloneInstalled,
       zaiApiKey: zaiApiKey ? this.settings.encodeApiKey(zaiApiKey) : null,
       installedAt: new Date().toISOString(),
       version: require('../package.json').version
@@ -147,6 +172,7 @@ class Installer {
       config: cfgInstalled,
       claudeZ: czInstalled,
       claudeHUD: hudInstalled,
+      rclone: rcloneInstalled,
       commands: cmdsInstalled
     });
 
@@ -214,6 +240,7 @@ class Installer {
       { name: 'CLAUDE.md', installed: results.config },
       { name: 'Claude-Z', installed: results.claudeZ },
       { name: 'Claude HUD', installed: results.claudeHUD },
+      { name: 'rclone', installed: results.rclone },
       { name: 'ZC Commands', installed: results.commands }
     ];
 
@@ -251,6 +278,11 @@ class Installer {
       console.log('  For Claude HUD: run setup-claude-hud');
       console.log('');
     }
+
+    if (results.rclone) {
+      console.log('  Cloud backup ready! Configure with: rclone config');
+      console.log('');
+    }
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zuppaclaude",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Claude Code power-up installer - SuperClaude + Spec Kit + Claude-Z + Claude HUD",
   "main": "lib/index.js",
   "bin": {