zuppaclaude 1.0.2 → 1.2.0

package/README.md

@@ -197,26 +197,48 @@ npx zuppaclaude settings reset             # 🔄 Fabrika ayarları
 | 🔐 API key koruması | Base64 encoded saklama |
 | 🛡️ Uninstall koruması | Kaldırırken ayarları koruma opsiyonu |
 
-### 💾 Session Yedekleme
+### 💾 Yedekleme & Geri Yükleme
 
-Claude Code session'larınızı yedekleyin ve geri yükleyin. Context kaybı, format veya compacting durumlarında kullanışlı.
+Claude Code session'larınızı ve ayarlarınızı yedekleyin. Context kaybı, format veya compacting durumlarında kullanışlı.
 
+**🔄 Tam Yedekleme (Sessions + Ayarlar):**
+```bash
+npx zuppaclaude backup              # 💾 Lokal tam yedek
+npx zuppaclaude backup --cloud gdrive  # ☁️ Google Drive'a yedekle
+npx zuppaclaude restore <id>        # ♻️ Yedekten geri yükle
+npx zuppaclaude restore <id> --cloud gdrive  # ☁️ Cloud'dan geri yükle
+```
+
+**📋 Sadece Session İşlemleri:**
 ```bash
 npx zuppaclaude session list        # 📋 Tüm session'ları listele
-npx zuppaclaude session backup      # 💾 Tüm session'ları yedekle
+npx zuppaclaude session backup      # 💾 Sadece session'ları yedekle
 npx zuppaclaude session backups     # 📦 Mevcut yedekleri listele
-npx zuppaclaude session restore <id> # ♻️ Yedekten geri yükle
-npx zuppaclaude session export <id>  # 📤 Belirli session'ı export et
 ```
 
-**📁 Yedek konumu:** `~/.config/zuppaclaude/backups/`
+### ☁️ Cloud Yedekleme (rclone)
+
+Google Drive, Dropbox, OneDrive, S3, SFTP ve 40+ cloud servise yedekleme.
+
+```bash
+# Kurulum
+brew install rclone      # macOS
+rclone config            # Remote ayarla (gdrive, dropbox vs.)
+
+# Kullanım
+npx zuppaclaude cloud setup         # 📖 Kurulum talimatları
+npx zuppaclaude cloud remotes       # 📋 Mevcut remote'ları listele
+npx zuppaclaude backup --cloud gdrive  # ☁️ Yedekle ve upload et
+npx zuppaclaude cloud backups gdrive   # 📦 Cloud'daki yedekleri listele
+```
 
 **✨ Özellikler:**
 | Özellik | Açıklama |
 |---------|----------|
 | 🔒 Güvenli restore | Mevcut session'lar üzerine yazılmaz |
-| 📜 History desteği | Command history de yedeklenir |
-| 📋 Manifest | Her yedekte metadata saklanır |
+| 📜 Tam yedek | Sessions + Settings + History |
+| ☁️ 40+ cloud | rclone ile Google Drive, Dropbox, S3, SFTP... |
+| 🔐 Encryption | rclone encryption desteği |
 
 ### 🗑️ Kaldırma
 
@@ -444,26 +466,48 @@ npx zuppaclaude settings reset             # 🔄 Reset to defaults
 | 🔐 API key protection | Base64 encoded storage |
 | 🛡️ Uninstall protection | Option to preserve settings when uninstalling |
 
-### 💾 Session Backup
+### 💾 Backup & Restore
 
-Backup and restore your Claude Code sessions. Useful for context loss, formatting, or conversation compacting.
+Backup your Claude Code sessions and settings. Useful for context loss, formatting, or conversation compacting.
 
+**🔄 Full Backup (Sessions + Settings):**
+```bash
+npx zuppaclaude backup              # 💾 Local full backup
+npx zuppaclaude backup --cloud gdrive  # ☁️ Backup to Google Drive
+npx zuppaclaude restore <id>        # ♻️ Restore from backup
+npx zuppaclaude restore <id> --cloud gdrive  # ☁️ Restore from cloud
+```
+
+**📋 Session-only Operations:**
 ```bash
 npx zuppaclaude session list        # 📋 List all sessions
-npx zuppaclaude session backup      # 💾 Backup all sessions
+npx zuppaclaude session backup      # 💾 Backup sessions only
 npx zuppaclaude session backups     # 📦 List available backups
-npx zuppaclaude session restore <id> # ♻️ Restore from backup
-npx zuppaclaude session export <id>  # 📤 Export specific session
 ```
 
-**📁 Backup location:** `~/.config/zuppaclaude/backups/`
+### ☁️ Cloud Backup (rclone)
+
+Backup to Google Drive, Dropbox, OneDrive, S3, SFTP, and 40+ cloud services.
+
+```bash
+# Setup
+brew install rclone      # macOS
+rclone config            # Configure remote (gdrive, dropbox, etc.)
+
+# Usage
+npx zuppaclaude cloud setup         # 📖 Setup instructions
+npx zuppaclaude cloud remotes       # 📋 List configured remotes
+npx zuppaclaude backup --cloud gdrive  # ☁️ Backup and upload
+npx zuppaclaude cloud backups gdrive   # 📦 List cloud backups
+```
 
 **✨ Features:**
 | Feature | Description |
 |---------|-------------|
 | 🔒 Safe restore | Existing sessions are not overwritten |
-| 📜 History support | Command history is also backed up |
-| 📋 Manifest | Metadata saved with each backup |
+| 📜 Full backup | Sessions + Settings + History |
+| ☁️ 40+ clouds | Google Drive, Dropbox, S3, SFTP via rclone |
+| 🔐 Encryption | rclone encryption support |
 
 ### 🗑️ Uninstall
 

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,81 @@
+---
+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 |
+
+## 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/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