zuppaclaude 1.3.17 → 1.3.19

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (9) hide show
  1. package/assets/commands/zc/backup.md +4 -51
  2. package/assets/commands/zc/cloud.md +8 -75
  3. package/assets/commands/zc/help.md +3 -80
  4. package/assets/commands/zc/hud.md +7 -35
  5. package/assets/commands/zc/restore.md +5 -55
  6. package/assets/commands/zc/session.md +7 -76
  7. package/assets/commands/zc/settings.md +2 -77
  8. package/assets/commands/zc/update.md +10 -0
  9. package/package.json +1 -1
package/assets/commands/zc/backup.md CHANGED
@@ -1,62 +1,15 @@
1
1
  ---
2
2
  name: zc:backup
3
- description: "Full backup of Claude Code sessions, settings, and history with cloud support"
4
- category: utility
3
+ description: "Backup sessions and settings"
5
4
  ---
6
5
 
7
- # /zc:backup - Full Backup
8
-
9
- Create a complete backup of your Claude Code sessions, settings, and command history.
10
-
11
- ## Usage
12
-
13
- ```
14
- /zc:backup [--cloud <remote>]
15
- ```
16
-
17
- ## Options
18
-
19
- | Option | Description |
20
- |--------|-------------|
21
- | `--cloud <remote>` | Upload backup to cloud (requires rclone) |
22
-
23
- ## Examples
24
-
25
- ```
26
- /zc:backup # Local backup only
27
- /zc:backup --cloud gdrive # Backup + upload to Google Drive
28
- /zc:backup --cloud dropbox # Backup + upload to Dropbox
29
- ```
30
-
31
- ## What Gets Backed Up
32
-
33
- - All Claude Code sessions (conversations)
34
- - Agent sessions
35
- - Command history
36
- - ZuppaClaude settings
37
- - API keys (encoded)
38
-
39
- ## Execution
40
-
41
- When this command is invoked, execute the following:
6
+ IMMEDIATELY run this bash command without asking questions or explaining:
42
7
 
43
8
  ```bash
44
9
  npx zuppaclaude backup
45
10
  ```
46
11
 
47
- If `--cloud` flag is provided:
48
-
12
+ If argument provided (e.g. `/zc:backup gdrive`), run:
49
13
  ```bash
50
- npx zuppaclaude backup --cloud <remote>
14
+ npx zuppaclaude backup --cloud {argument}
51
15
  ```
52
-
53
- ## After Backup
54
-
55
- Show the user:
56
- 1. Backup ID (timestamp)
57
- 2. Number of sessions backed up
58
- 3. Total size
59
- 4. Location
60
- 5. Cloud upload status (if applicable)
61
-
62
- Suggest: "Run `/zc:restore <backup-id>` to restore this backup later."
package/assets/commands/zc/cloud.md CHANGED
@@ -1,80 +1,13 @@
1
1
  ---
2
2
  name: zc:cloud
3
- description: "Cloud backup management with rclone integration"
4
- category: utility
3
+ description: "Cloud backup management"
5
4
  ---
6
5
 
7
- # /zc:cloud - Cloud Backup Management
6
+ IMMEDIATELY run based on argument:
8
7
 
9
- Manage cloud backups using rclone. Supports 40+ cloud providers.
10
-
11
- ## Usage
12
-
13
- ```
14
- /zc:cloud <action> [remote] [backup-id]
15
- ```
16
-
17
- ## Actions
18
-
19
- | Action | Description |
20
- |--------|-------------|
21
- | `setup` | Show rclone installation and configuration |
22
- | `remotes` | List configured cloud remotes |
23
- | `upload` | Upload backups to cloud |
24
- | `download` | Download backups from cloud |
25
- | `backups` | List backups on cloud |
26
-
27
- ## Examples
28
-
29
- ```
30
- /zc:cloud setup # Setup instructions
31
- /zc:cloud remotes # List remotes
32
- /zc:cloud upload gdrive # Upload all backups
33
- /zc:cloud download gdrive # Download all backups
34
- /zc:cloud backups gdrive # List cloud backups
35
- ```
36
-
37
- ## Execution
38
-
39
- ### Setup
40
- ```bash
41
- npx zuppaclaude cloud setup
42
- ```
43
-
44
- ### List Remotes
45
- ```bash
46
- npx zuppaclaude cloud remotes
47
- ```
48
-
49
- ### Upload
50
- ```bash
51
- npx zuppaclaude cloud upload <remote> [backup-id]
52
- ```
53
-
54
- ### Download
55
- ```bash
56
- npx zuppaclaude cloud download <remote> [backup-id]
57
- ```
58
-
59
- ### List Cloud Backups
60
- ```bash
61
- npx zuppaclaude cloud backups <remote>
62
- ```
63
-
64
- ## Supported Providers
65
-
66
- | Provider | Remote Name |
67
- |----------|-------------|
68
- | Google Drive | gdrive |
69
- | Dropbox | dropbox |
70
- | OneDrive | onedrive |
71
- | Amazon S3 | s3 |
72
- | SFTP | sftp |
73
- | FTP | ftp |
74
- | + 40 more | See rclone docs |
75
-
76
- ## First Time Setup
77
-
78
- 1. Install rclone: `brew install rclone`
79
- 2. Configure remote: `rclone config`
80
- 3. Use with ZuppaClaude: `/zc:backup --cloud <remote>`
8
+ No argument → `npx zuppaclaude cloud remotes`
9
+ `setup` → `npx zuppaclaude cloud setup`
10
+ `upload <remote>` → `npx zuppaclaude cloud upload <remote>`
11
+ `download <remote>` → `npx zuppaclaude cloud download <remote>`
12
+ `backups <remote>` → `npx zuppaclaude cloud backups <remote>`
13
+ `delete <remote>` → `npx zuppaclaude cloud delete <remote>`
package/assets/commands/zc/help.md CHANGED
@@ -1,87 +1,10 @@
1
1
  ---
2
2
  name: zc:help
3
- description: "ZuppaClaude help and documentation"
4
- category: utility
3
+ description: "ZuppaClaude help"
5
4
  ---
6
5
 
7
- # /zc:help - ZuppaClaude Help
8
-
9
- Display ZuppaClaude commands and documentation.
10
-
11
- ## Available Commands
12
-
13
- ### Backup & Restore
14
-
15
- | Command | Description |
16
- |---------|-------------|
17
- | `/zc:backup` | Full backup (sessions + settings) |
18
- | `/zc:backup --cloud gdrive` | Backup and upload to cloud |
19
- | `/zc:restore` | Restore from backup |
20
- | `/zc:restore <id> --cloud gdrive` | Restore from cloud |
21
-
22
- ### Session Management
23
-
24
- | Command | Description |
25
- |---------|-------------|
26
- | `/zc:session list` | List all sessions |
27
- | `/zc:session backup` | Backup sessions only |
28
- | `/zc:session backups` | List available backups |
29
- | `/zc:session export <id>` | Export specific session |
30
-
31
- ### Cloud Management
32
-
33
- | Command | Description |
34
- |---------|-------------|
35
- | `/zc:cloud setup` | Show rclone setup |
36
- | `/zc:cloud remotes` | List cloud remotes |
37
- | `/zc:cloud upload <r>` | Upload to cloud |
38
- | `/zc:cloud download <r>` | Download from cloud |
39
-
40
- ### Settings
41
-
42
- | Command | Description |
43
- |---------|-------------|
44
- | `/zc:settings show` | View settings |
45
- | `/zc:settings export` | Export settings |
46
- | `/zc:settings import` | Import settings |
47
- | `/zc:settings reset` | Reset to defaults |
48
-
49
- ### Claude HUD
50
-
51
- | Command | Description |
52
- |---------|-------------|
53
- | `/zc:hud` | Claude HUD setup instructions |
54
-
55
- ## Quick Start
56
-
57
- ```
58
- # First time? Create a backup:
59
- /zc:backup
60
-
61
- # Set up cloud backup:
62
- /zc:cloud setup
63
-
64
- # Restore if needed:
65
- /zc:restore
66
- ```
67
-
68
- ## CLI Commands
69
-
70
- All commands also work from terminal:
6
+ IMMEDIATELY run this bash command without asking questions or explaining:
71
7
 
72
8
  ```bash
73
- npx zuppaclaude backup
74
- npx zuppaclaude restore <id>
75
- npx zuppaclaude session list
76
- npx zuppaclaude cloud setup
77
- npx zuppaclaude settings show
9
+ npx zuppaclaude help
78
10
  ```
79
-
80
- ## Links
81
-
82
- - GitHub: https://github.com/hasankaantan/zuppaclaude
83
- - NPM: https://www.npmjs.com/package/zuppaclaude
84
-
85
- ## Execution
86
-
87
- When this command is invoked, show this help information to the user.
package/assets/commands/zc/hud.md CHANGED
@@ -1,45 +1,17 @@
1
1
  ---
2
2
  name: zc:hud
3
- description: "Claude HUD setup instructions"
4
- category: utility
3
+ description: "Claude HUD status display management"
5
4
  ---
6
5
 
7
- # /zc:hud - Claude HUD Setup
6
+ Claude HUD is automatically installed and configured by ZuppaClaude.
8
7
 
9
- Display Claude HUD installation instructions.
10
-
11
- ## What is Claude HUD?
12
-
13
- Claude HUD is a status display plugin that provides:
14
- - Real-time context usage meter
15
- - Active tool tracking
16
- - Running agent status
17
- - Todo progress display
18
-
19
- ## Installation Steps
20
-
21
- Run these commands inside Claude Code:
22
-
23
- ```
24
- 1. /plugin marketplace add jarrodwatts/claude-hud
25
- 2. /plugin install claude-hud
26
- 3. /claude-hud:setup
27
- ```
28
-
29
- ## Requirements
30
-
31
- - Claude Code v1.0.80 or later
32
- - Plugin support enabled
33
-
34
- ## CLI Alternative
8
+ To reinstall/update HUD, run:
35
9
 
36
10
  ```bash
37
- setup-claude-hud
11
+ npx zuppaclaude
38
12
  ```
39
13
 
40
- ## Execution
14
+ And select Yes for Claude HUD installation.
41
15
 
42
- When this command is invoked:
43
- 1. Show the Claude HUD information above
44
- 2. Guide the user through the installation steps
45
- 3. Explain that they need to run the plugin commands in Claude Code
16
+ HUD location: `~/.claude/plugins/claude-hud/`
17
+ Config: `~/.claude/settings.json` → `statusLine`
package/assets/commands/zc/restore.md CHANGED
@@ -1,65 +1,15 @@
1
1
  ---
2
2
  name: zc:restore
3
- description: "Restore Claude Code sessions and settings from backup"
4
- category: utility
3
+ description: "Restore from backup"
5
4
  ---
6
5
 
7
- # /zc:restore - Restore from Backup
8
-
9
- Restore your Claude Code sessions and settings from a previous backup.
10
-
11
- ## Usage
12
-
13
- ```
14
- /zc:restore [backup-id] [--cloud <remote>]
15
- ```
16
-
17
- ## Options
18
-
19
- | Option | Description |
20
- |--------|-------------|
21
- | `backup-id` | Specific backup to restore (e.g., 2026-01-05T12-00-00) |
22
- | `--cloud <remote>` | Download backup from cloud first |
23
-
24
- ## Examples
25
-
26
- ```
27
- /zc:restore # Show available backups
28
- /zc:restore 2026-01-05T12-00-00 # Restore specific backup
29
- /zc:restore latest # Restore most recent backup
30
- /zc:restore latest --cloud gdrive # Restore from Google Drive
31
- ```
32
-
33
- ## Execution Flow
34
-
35
- ### Step 1: List Available Backups
36
-
37
- If no backup-id provided, first run:
38
-
6
+ If no backup ID argument, first run:
39
7
  ```bash
40
8
  npx zuppaclaude session backups
41
9
  ```
10
+ Then ask which one to restore.
42
11
 
43
- Show the list and ask user to select a backup.
44
-
45
- ### Step 2: Restore
46
-
47
- ```bash
48
- npx zuppaclaude restore <backup-id>
49
- ```
50
-
51
- If `--cloud` flag is provided:
52
-
12
+ With backup ID argument, IMMEDIATELY run:
53
13
  ```bash
54
- npx zuppaclaude restore <backup-id> --cloud <remote>
14
+ npx zuppaclaude restore {backup-id}
55
15
  ```
56
-
57
- ## Safety
58
-
59
- - Existing sessions are NOT overwritten
60
- - Restored sessions get `.restored` suffix
61
- - User can manually merge if needed
62
-
63
- ## After Restore
64
-
65
- Remind user: "Restart Claude Code to see restored sessions."
package/assets/commands/zc/session.md CHANGED
@@ -1,81 +1,12 @@
1
1
  ---
2
2
  name: zc:session
3
- description: "Claude Code session management - list, backup, restore, export"
4
- category: utility
3
+ description: "Session management"
5
4
  ---
6
5
 
7
- # /zc:session - Session Management
6
+ IMMEDIATELY run based on argument:
8
7
 
9
- Manage your Claude Code conversation sessions.
10
-
11
- ## Usage
12
-
13
- ```
14
- /zc:session <action> [args]
15
- ```
16
-
17
- ## Actions
18
-
19
- | Action | Description |
20
- |--------|-------------|
21
- | `list` | List all sessions with details |
22
- | `backup` | Backup sessions only (not settings) |
23
- | `backups` | List available backups |
24
- | `restore` | Restore sessions from backup |
25
- | `export` | Export a specific session to file |
26
-
27
- ## Examples
28
-
29
- ```
30
- /zc:session list # List all sessions
31
- /zc:session backup # Backup sessions
32
- /zc:session backups # List backups
33
- /zc:session restore 2026-01-05T12-00-00 # Restore from backup
34
- /zc:session export abc123 ./my-session.jsonl # Export session
35
- ```
36
-
37
- ## Execution
38
-
39
- ### List Sessions
40
- ```bash
41
- npx zuppaclaude session list
42
- ```
43
-
44
- Shows:
45
- - Project paths
46
- - Session IDs
47
- - Session types (main vs agent)
48
- - Size and last modified
49
-
50
- ### Backup Sessions
51
- ```bash
52
- npx zuppaclaude session backup
53
- ```
54
-
55
- ### List Backups
56
- ```bash
57
- npx zuppaclaude session backups
58
- ```
59
-
60
- ### Restore Sessions
61
- ```bash
62
- npx zuppaclaude session restore <backup-id>
63
- ```
64
-
65
- ### Export Session
66
- ```bash
67
- npx zuppaclaude session export <session-id> [output-file]
68
- ```
69
-
70
- ## Session Types
71
-
72
- | Icon | Type | Description |
73
- |------|------|-------------|
74
- | 💬 | Main | Primary conversation sessions |
75
- | 🤖 | Agent | Sub-agent sessions |
76
-
77
- ## Tips
78
-
79
- - Use `/zc:backup` for full backup (sessions + settings)
80
- - Sessions are stored in `~/.claude/projects/`
81
- - Backups are stored in `~/.config/zuppaclaude/backups/`
8
+ No argument → `npx zuppaclaude session list`
9
+ `backup` → `npx zuppaclaude session backup`
10
+ `backups` → `npx zuppaclaude session backups`
11
+ `restore <id>` → `npx zuppaclaude session restore <id>`
12
+ `export <id>` → `npx zuppaclaude session export <id>`
package/assets/commands/zc/settings.md CHANGED
@@ -1,85 +1,10 @@
1
1
  ---
2
2
  name: zc:settings
3
- description: "ZuppaClaude settings management - view, export, import, reset"
4
- category: utility
3
+ description: "Show ZuppaClaude settings"
5
4
  ---
6
5
 
7
- # /zc:settings - Settings Management
6
+ IMMEDIATELY run this bash command without asking questions or explaining:
8
7
 
9
- Manage ZuppaClaude configuration and preferences.
10
-
11
- ## Usage
12
-
13
- ```
14
- /zc:settings <action> [file]
15
- ```
16
-
17
- ## Actions
18
-
19
- | Action | Description |
20
- |--------|-------------|
21
- | `show` | Display current settings |
22
- | `export` | Export settings to file |
23
- | `import` | Import settings from file |
24
- | `reset` | Reset to defaults |
25
- | `path` | Show settings file path |
26
-
27
- ## Examples
28
-
29
- ```
30
- /zc:settings show # View settings
31
- /zc:settings export ~/backup.json # Export settings
32
- /zc:settings import ~/backup.json # Import settings
33
- /zc:settings reset # Reset to defaults
34
- /zc:settings path # Show file path
35
- ```
36
-
37
- ## Execution
38
-
39
- ### Show Settings
40
8
  ```bash
41
9
  npx zuppaclaude settings show
42
10
  ```
43
-
44
- ### Export Settings
45
- ```bash
46
- npx zuppaclaude settings export <file>
47
- ```
48
-
49
- ### Import Settings
50
- ```bash
51
- npx zuppaclaude settings import <file>
52
- ```
53
-
54
- ### Reset Settings
55
- ```bash
56
- npx zuppaclaude settings reset
57
- ```
58
-
59
- ### Show Path
60
- ```bash
61
- npx zuppaclaude settings path
62
- ```
63
-
64
- ## What's Stored
65
-
66
- | Setting | Description |
67
- |---------|-------------|
68
- | `specKit` | Spec Kit installation preference |
69
- | `claudeZ` | Claude-Z installation preference |
70
- | `claudeHUD` | Claude HUD installation preference |
71
- | `zaiApiKey` | Z.AI API key (encoded) |
72
- | `installedAt` | Installation timestamp |
73
- | `version` | ZuppaClaude version |
74
-
75
- ## Settings Location
76
-
77
- ```
78
- ~/.config/zuppaclaude/zc-settings.json
79
- ```
80
-
81
- ## Tips
82
-
83
- - Settings are automatically saved after installation
84
- - Previous settings are used on reinstall
85
- - Use `/zc:backup` to backup settings with sessions
package/assets/commands/zc/update.md ADDED
@@ -0,0 +1,10 @@
1
+ ---
2
+ name: zc:update
3
+ description: "Update ZuppaClaude"
4
+ ---
5
+
6
+ IMMEDIATELY run this bash command without asking questions or explaining:
7
+
8
+ ```bash
9
+ npx zuppaclaude@latest update now
10
+ ```
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "zuppaclaude",
3
- "version": "1.3.17",
3
+ "version": "1.3.19",
4
4
  "description": "Claude Code power-up installer - SuperClaude + Spec Kit + Claude-Z + Claude HUD",
5
5
  "main": "lib/index.js",
6
6
  "bin": {