zuppaclaude 1.1.0 → 1.2.1

package/assets/commands/zc/README.md

@@ -0,0 +1,31 @@
+# ZuppaClaude Commands
+
+ZuppaClaude slash commands for Claude Code session and backup management.
+
+## Available Commands
+
+| Command | Description |
+|---------|-------------|
+| `/zc:backup` | Full backup (sessions + settings + cloud) |
+| `/zc:restore` | Restore from backup |
+| `/zc:cloud` | Cloud backup management |
+| `/zc:session` | Session management |
+| `/zc:settings` | Settings management |
+| `/zc:help` | Show help and documentation |
+
+## Quick Start
+
+```
+/zc:backup              # Create full backup
+/zc:backup --cloud      # Backup to cloud
+/zc:restore             # Restore from latest backup
+/zc:session list        # List all sessions
+```
+
+## Installation
+
+These commands are installed automatically with ZuppaClaude:
+
+```bash
+npx zuppaclaude install
+```

package/assets/commands/zc/backup.md

@@ -0,0 +1,62 @@
+---
+name: zc:backup
+description: "Full backup of Claude Code sessions, settings, and history with cloud support"
+category: utility
+---
+
+# /zc:backup - Full Backup
+
+Create a complete backup of your Claude Code sessions, settings, and command history.
+
+## Usage
+
+```
+/zc:backup [--cloud <remote>]
+```
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `--cloud <remote>` | Upload backup to cloud (requires rclone) |
+
+## Examples
+
+```
+/zc:backup                    # Local backup only
+/zc:backup --cloud gdrive     # Backup + upload to Google Drive
+/zc:backup --cloud dropbox    # Backup + upload to Dropbox
+```
+
+## What Gets Backed Up
+
+- All Claude Code sessions (conversations)
+- Agent sessions
+- Command history
+- ZuppaClaude settings
+- API keys (encoded)
+
+## Execution
+
+When this command is invoked, execute the following:
+
+```bash
+npx zuppaclaude backup
+```
+
+If `--cloud` flag is provided:
+
+```bash
+npx zuppaclaude backup --cloud <remote>
+```
+
+## After Backup
+
+Show the user:
+1. Backup ID (timestamp)
+2. Number of sessions backed up
+3. Total size
+4. Location
+5. Cloud upload status (if applicable)
+
+Suggest: "Run `/zc:restore <backup-id>` to restore this backup later."

package/assets/commands/zc/cloud.md

@@ -0,0 +1,80 @@
+---
+name: zc:cloud
+description: "Cloud backup management with rclone integration"
+category: utility
+---
+
+# /zc:cloud - Cloud Backup Management
+
+Manage cloud backups using rclone. Supports 40+ cloud providers.
+
+## Usage
+
+```
+/zc:cloud <action> [remote] [backup-id]
+```
+
+## Actions
+
+| Action | Description |
+|--------|-------------|
+| `setup` | Show rclone installation and configuration |
+| `remotes` | List configured cloud remotes |
+| `upload` | Upload backups to cloud |
+| `download` | Download backups from cloud |
+| `backups` | List backups on cloud |
+
+## Examples
+
+```
+/zc:cloud setup                    # Setup instructions
+/zc:cloud remotes                  # List remotes
+/zc:cloud upload gdrive            # Upload all backups
+/zc:cloud download gdrive          # Download all backups
+/zc:cloud backups gdrive           # List cloud backups
+```
+
+## Execution
+
+### Setup
+```bash
+npx zuppaclaude cloud setup
+```
+
+### List Remotes
+```bash
+npx zuppaclaude cloud remotes
+```
+
+### Upload
+```bash
+npx zuppaclaude cloud upload <remote> [backup-id]
+```
+
+### Download
+```bash
+npx zuppaclaude cloud download <remote> [backup-id]
+```
+
+### List Cloud Backups
+```bash
+npx zuppaclaude cloud backups <remote>
+```
+
+## Supported Providers
+
+| Provider | Remote Name |
+|----------|-------------|
+| Google Drive | gdrive |
+| Dropbox | dropbox |
+| OneDrive | onedrive |
+| Amazon S3 | s3 |
+| SFTP | sftp |
+| FTP | ftp |
+| + 40 more | See rclone docs |
+
+## First Time Setup
+
+1. Install rclone: `brew install rclone`
+2. Configure remote: `rclone config`
+3. Use with ZuppaClaude: `/zc:backup --cloud <remote>`

package/assets/commands/zc/help.md

@@ -0,0 +1,87 @@
+---
+name: zc:help
+description: "ZuppaClaude help and documentation"
+category: utility
+---
+
+# /zc:help - ZuppaClaude Help
+
+Display ZuppaClaude commands and documentation.
+
+## Available Commands
+
+### Backup & Restore
+
+| Command | Description |
+|---------|-------------|
+| `/zc:backup` | Full backup (sessions + settings) |
+| `/zc:backup --cloud gdrive` | Backup and upload to cloud |
+| `/zc:restore` | Restore from backup |
+| `/zc:restore <id> --cloud gdrive` | Restore from cloud |
+
+### Session Management
+
+| Command | Description |
+|---------|-------------|
+| `/zc:session list` | List all sessions |
+| `/zc:session backup` | Backup sessions only |
+| `/zc:session backups` | List available backups |
+| `/zc:session export <id>` | Export specific session |
+
+### Cloud Management
+
+| Command | Description |
+|---------|-------------|
+| `/zc:cloud setup` | Show rclone setup |
+| `/zc:cloud remotes` | List cloud remotes |
+| `/zc:cloud upload <r>` | Upload to cloud |
+| `/zc:cloud download <r>` | Download from cloud |
+
+### Settings
+
+| Command | Description |
+|---------|-------------|
+| `/zc:settings show` | View settings |
+| `/zc:settings export` | Export settings |
+| `/zc:settings import` | Import settings |
+| `/zc:settings reset` | Reset to defaults |
+
+### Claude HUD
+
+| Command | Description |
+|---------|-------------|
+| `/zc:hud` | Claude HUD setup instructions |
+
+## Quick Start
+
+```
+# First time? Create a backup:
+/zc:backup
+
+# Set up cloud backup:
+/zc:cloud setup
+
+# Restore if needed:
+/zc:restore
+```
+
+## CLI Commands
+
+All commands also work from terminal:
+
+```bash
+npx zuppaclaude backup
+npx zuppaclaude restore <id>
+npx zuppaclaude session list
+npx zuppaclaude cloud setup
+npx zuppaclaude settings show
+```
+
+## Links
+
+- GitHub: https://github.com/hasankaantan/zuppaclaude
+- NPM: https://www.npmjs.com/package/zuppaclaude
+
+## Execution
+
+When this command is invoked, show this help information to the user.

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/assets/commands/zc/restore.md

@@ -0,0 +1,65 @@
+---
+name: zc:restore
+description: "Restore Claude Code sessions and settings from backup"
+category: utility
+---
+
+# /zc:restore - Restore from Backup
+
+Restore your Claude Code sessions and settings from a previous backup.
+
+## Usage
+
+```
+/zc:restore [backup-id] [--cloud <remote>]
+```
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `backup-id` | Specific backup to restore (e.g., 2026-01-05T12-00-00) |
+| `--cloud <remote>` | Download backup from cloud first |
+
+## Examples
+
+```
+/zc:restore                              # Show available backups
+/zc:restore 2026-01-05T12-00-00          # Restore specific backup
+/zc:restore latest                       # Restore most recent backup
+/zc:restore latest --cloud gdrive        # Restore from Google Drive
+```
+
+## Execution Flow
+
+### Step 1: List Available Backups
+
+If no backup-id provided, first run:
+
+```bash
+npx zuppaclaude session backups
+```
+
+Show the list and ask user to select a backup.
+
+### Step 2: Restore
+
+```bash
+npx zuppaclaude restore <backup-id>
+```
+
+If `--cloud` flag is provided:
+
+```bash
+npx zuppaclaude restore <backup-id> --cloud <remote>
+```
+
+## Safety
+
+- Existing sessions are NOT overwritten
+- Restored sessions get `.restored` suffix
+- User can manually merge if needed
+
+## After Restore
+
+Remind user: "Restart Claude Code to see restored sessions."

package/assets/commands/zc/session.md

@@ -0,0 +1,81 @@
+---
+name: zc:session
+description: "Claude Code session management - list, backup, restore, export"
+category: utility
+---
+
+# /zc:session - Session Management
+
+Manage your Claude Code conversation sessions.
+
+## Usage
+
+```
+/zc:session <action> [args]
+```
+
+## Actions
+
+| Action | Description |
+|--------|-------------|
+| `list` | List all sessions with details |
+| `backup` | Backup sessions only (not settings) |
+| `backups` | List available backups |
+| `restore` | Restore sessions from backup |
+| `export` | Export a specific session to file |
+
+## Examples
+
+```
+/zc:session list                              # List all sessions
+/zc:session backup                            # Backup sessions
+/zc:session backups                           # List backups
+/zc:session restore 2026-01-05T12-00-00       # Restore from backup
+/zc:session export abc123 ./my-session.jsonl  # Export session
+```
+
+## Execution
+
+### List Sessions
+```bash
+npx zuppaclaude session list
+```
+
+Shows:
+- Project paths
+- Session IDs
+- Session types (main vs agent)
+- Size and last modified
+
+### Backup Sessions
+```bash
+npx zuppaclaude session backup
+```
+
+### List Backups
+```bash
+npx zuppaclaude session backups
+```
+
+### Restore Sessions
+```bash
+npx zuppaclaude session restore <backup-id>
+```
+
+### Export Session
+```bash
+npx zuppaclaude session export <session-id> [output-file]
+```
+
+## Session Types
+
+| Icon | Type | Description |
+|------|------|-------------|
+| 💬 | Main | Primary conversation sessions |
+| 🤖 | Agent | Sub-agent sessions |
+
+## Tips
+
+- Use `/zc:backup` for full backup (sessions + settings)
+- Sessions are stored in `~/.claude/projects/`
+- Backups are stored in `~/.config/zuppaclaude/backups/`

package/assets/commands/zc/settings.md

@@ -0,0 +1,85 @@
+---
+name: zc:settings
+description: "ZuppaClaude settings management - view, export, import, reset"
+category: utility
+---
+
+# /zc:settings - Settings Management
+
+Manage ZuppaClaude configuration and preferences.
+
+## Usage
+
+```
+/zc:settings <action> [file]
+```
+
+## Actions
+
+| Action | Description |
+|--------|-------------|
+| `show` | Display current settings |
+| `export` | Export settings to file |
+| `import` | Import settings from file |
+| `reset` | Reset to defaults |
+| `path` | Show settings file path |
+
+## Examples
+
+```
+/zc:settings show                    # View settings
+/zc:settings export ~/backup.json    # Export settings
+/zc:settings import ~/backup.json    # Import settings
+/zc:settings reset                   # Reset to defaults
+/zc:settings path                    # Show file path
+```
+
+## Execution
+
+### Show Settings
+```bash
+npx zuppaclaude settings show
+```
+
+### Export Settings
+```bash
+npx zuppaclaude settings export <file>
+```
+
+### Import Settings
+```bash
+npx zuppaclaude settings import <file>
+```
+
+### Reset Settings
+```bash
+npx zuppaclaude settings reset
+```
+
+### Show Path
+```bash
+npx zuppaclaude settings path
+```
+
+## What's Stored
+
+| Setting | Description |
+|---------|-------------|
+| `specKit` | Spec Kit installation preference |
+| `claudeZ` | Claude-Z installation preference |
+| `claudeHUD` | Claude HUD installation preference |
+| `zaiApiKey` | Z.AI API key (encoded) |
+| `installedAt` | Installation timestamp |
+| `version` | ZuppaClaude version |
+
+## Settings Location
+
+```
+~/.config/zuppaclaude/zc-settings.json
+```
+
+## Tips
+
+- Settings are automatically saved after installation
+- Previous settings are used on reinstall
+- Use `/zc:backup` to backup settings with sessions

package/lib/components/commands.js

@@ -0,0 +1,140 @@
+/**
+ * ZuppaClaude Commands Installer
+ * Installs /zc:* slash commands for Claude Code
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { Logger } = require('../utils/logger');
+const { Platform } = require('../utils/platform');
+
+class CommandsInstaller {
+  constructor() {
+    this.platform = new Platform();
+    this.logger = new Logger();
+    this.commandsDir = path.join(this.platform.claudeDir, 'commands', 'zc');
+    this.sourceDir = path.join(__dirname, '..', '..', 'assets', 'commands', 'zc');
+  }
+
+  /**
+   * Check if commands are installed
+   */
+  isInstalled() {
+    return fs.existsSync(this.commandsDir) &&
+           fs.existsSync(path.join(this.commandsDir, 'help.md'));
+  }
+
+  /**
+   * Install ZuppaClaude commands
+   */
+  async install() {
+    this.logger.step('Installing ZuppaClaude Slash Commands');
+
+    try {
+      // Ensure commands directory exists
+      this.platform.ensureDir(this.commandsDir);
+
+      // Get list of command files
+      const files = fs.readdirSync(this.sourceDir);
+
+      let installed = 0;
+      for (const file of files) {
+        if (!file.endsWith('.md')) continue;
+
+        const srcPath = path.join(this.sourceDir, file);
+        const destPath = path.join(this.commandsDir, file);
+
+        try {
+          fs.copyFileSync(srcPath, destPath);
+          installed++;
+        } catch (error) {
+          this.logger.warning(`Failed to install ${file}: ${error.message}`);
+        }
+      }
+
+      this.logger.success(`Installed ${installed} slash commands`);
+      this.logger.info('Commands available: /zc:backup, /zc:restore, /zc:cloud, /zc:session, /zc:settings, /zc:hud, /zc:help');
+
+      return true;
+    } catch (error) {
+      this.logger.error(`Failed to install commands: ${error.message}`);
+      return false;
+    }
+  }
+
+  /**
+   * Uninstall commands
+   */
+  uninstall() {
+    if (!fs.existsSync(this.commandsDir)) {
+      this.logger.info('ZuppaClaude commands not found');
+      return true;
+    }
+
+    try {
+      fs.rmSync(this.commandsDir, { recursive: true });
+      this.logger.success('ZuppaClaude commands removed');
+      return true;
+    } catch (error) {
+      this.logger.error(`Failed to remove commands: ${error.message}`);
+      return false;
+    }
+  }
+
+  /**
+   * Verify installation
+   */
+  verify() {
+    if (this.isInstalled()) {
+      this.logger.success('ZuppaClaude Commands: Installed');
+
+      // Count installed commands
+      try {
+        const files = fs.readdirSync(this.commandsDir)
+          .filter(f => f.endsWith('.md') && f !== 'README.md');
+        this.logger.info(`Available: /zc:${files.map(f => f.replace('.md', '')).join(', /zc:')}`);
+      } catch (e) {
+        // Ignore
+      }
+
+      return true;
+    } else {
+      this.logger.warning('ZuppaClaude Commands: Not installed');
+      return false;
+    }
+  }
+
+  /**
+   * List available commands
+   */
+  list() {
+    console.log('');
+    console.log('\x1b[35m═══════════════════════════════════════════════════════════════════\x1b[0m');
+    console.log('\x1b[35m                    ZuppaClaude Commands\x1b[0m');
+    console.log('\x1b[35m═══════════════════════════════════════════════════════════════════\x1b[0m');
+    console.log('');
+
+    const commands = [
+      { cmd: '/zc:backup', desc: 'Full backup (sessions + settings + cloud)' },
+      { cmd: '/zc:restore', desc: 'Restore from backup' },
+      { 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' }
+    ];
+
+    for (const { cmd, desc } of commands) {
+      console.log(`  \x1b[36m${cmd.padEnd(18)}\x1b[0m ${desc}`);
+    }
+
+    console.log('');
+    console.log('Usage:');
+    console.log('  Type the command in Claude Code chat, e.g., /zc:backup');
+    console.log('');
+
+    return commands;
+  }
+}
+
+module.exports = { CommandsInstaller };

package/lib/components/index.js

@@ -10,6 +10,7 @@ const { ClaudeHUDInstaller } = require('./claudehud');
 const { SessionManager } = require('./session');
 const { CloudManager } = require('./cloud');
 const { BackupManager } = require('./backup');
+const { CommandsInstaller } = require('./commands');
 
 module.exports = {
   SuperClaudeInstaller,
@@ -19,5 +20,6 @@ module.exports = {
   ClaudeHUDInstaller,
   SessionManager,
   CloudManager,
-  BackupManager
+  BackupManager,
+  CommandsInstaller
 };

package/lib/installer.js

@@ -11,7 +11,8 @@ const {
   SpecKitInstaller,
   ConfigInstaller,
   ClaudeZInstaller,
-  ClaudeHUDInstaller
+  ClaudeHUDInstaller,
+  CommandsInstaller
 } = require('./components');
 
 class Installer {
@@ -27,6 +28,7 @@ class Installer {
     this.config = new ConfigInstaller();
     this.claudeZ = new ClaudeZInstaller();
     this.claudeHUD = new ClaudeHUDInstaller();
+    this.commands = new CommandsInstaller();
   }
 
   /**
@@ -36,7 +38,7 @@ class Installer {
     this.logger.banner();
 
     // Step 1: Check dependencies
-    this.logger.step('Step 1/7: Checking Dependencies');
+    this.logger.step('Step 1/8: Checking Dependencies');
     const depsOk = await this.checkDependencies();
     if (!depsOk) {
       this.logger.error('Dependency check failed. Please install required dependencies.');
@@ -110,8 +112,12 @@ class Installer {
       this.logger.info('Skipping Claude HUD installation');
     }
 
-    // Step 7: Verification
-    this.logger.step('Step 7/7: Verifying Installation');
+    // Step 7: Install ZuppaClaude Commands
+    this.logger.step('Step 7/8: Installing ZuppaClaude Slash Commands');
+    const cmdsInstalled = await this.commands.install();
+
+    // Step 8: Verification
+    this.logger.step('Step 8/8: Verifying Installation');
     console.log('');
 
     this.superClaude.verify();
@@ -119,6 +125,7 @@ class Installer {
     this.config.verify();
     if (installClaudeZ) this.claudeZ.verify();
     if (installClaudeHUD) this.claudeHUD.verify();
+    this.commands.verify();
 
     // Save settings
     const newSettings = {
@@ -139,7 +146,8 @@ class Installer {
       specKit: skInstalled,
       config: cfgInstalled,
       claudeZ: czInstalled,
-      claudeHUD: hudInstalled
+      claudeHUD: hudInstalled,
+      commands: cmdsInstalled
     });
 
     return true;
@@ -205,7 +213,8 @@ class Installer {
       { name: 'Spec Kit', installed: results.specKit },
       { name: 'CLAUDE.md', installed: results.config },
       { name: 'Claude-Z', installed: results.claudeZ },
-      { name: 'Claude HUD', installed: results.claudeHUD }
+      { name: 'Claude HUD', installed: results.claudeHUD },
+      { name: 'ZC Commands', installed: results.commands }
     ];
 
     let installed = 0;
@@ -223,7 +232,14 @@ class Installer {
     console.log('  Next steps:');
     console.log('  1. Restart your terminal or run: source ~/.bashrc');
     console.log('  2. Start Claude Code: claude');
-    console.log('  3. Try: /sc:help');
+    console.log('  3. Try: /sc:help or /zc:help');
+    console.log('');
+
+    console.log('  ZuppaClaude commands:');
+    console.log('  /zc:backup    - Full backup (sessions + settings)');
+    console.log('  /zc:restore   - Restore from backup');
+    console.log('  /zc:cloud     - Cloud backup management');
+    console.log('  /zc:help      - Show all commands');
     console.log('');
 
     if (results.claudeZ) {

package/lib/uninstaller.js

@@ -10,7 +10,8 @@ const {
   SpecKitInstaller,
   ConfigInstaller,
   ClaudeZInstaller,
-  ClaudeHUDInstaller
+  ClaudeHUDInstaller,
+  CommandsInstaller
 } = require('./components');
 
 class Uninstaller {
@@ -25,6 +26,7 @@ class Uninstaller {
     this.config = new ConfigInstaller();
     this.claudeZ = new ClaudeZInstaller();
     this.claudeHUD = new ClaudeHUDInstaller();
+    this.commands = new CommandsInstaller();
   }
 
   /**
@@ -57,7 +59,8 @@ class Uninstaller {
       specKit: this.specKit.uninstall(),
       config: this.config.uninstall(),
       claudeZ: this.claudeZ.uninstall(),
-      claudeHUD: this.claudeHUD.uninstall()
+      claudeHUD: this.claudeHUD.uninstall(),
+      commands: this.commands.uninstall()
     };
 
     // Handle settings
@@ -89,7 +92,8 @@ class Uninstaller {
       { name: 'Spec Kit', removed: results.specKit },
       { name: 'CLAUDE.md', removed: results.config },
       { name: 'Claude-Z', removed: results.claudeZ },
-      { name: 'Claude HUD', removed: results.claudeHUD }
+      { name: 'Claude HUD', removed: results.claudeHUD },
+      { name: 'ZC Commands', removed: results.commands }
     ];
 
     let removed = 0;

package/package.json

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