zuppaclaude 1.3.17 → 1.3.18

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 -48
  2. package/assets/commands/zc/cloud.md +15 -57
  3. package/assets/commands/zc/help.md +4 -79
  4. package/assets/commands/zc/hud.md +7 -35
  5. package/assets/commands/zc/restore.md +5 -46
  6. package/assets/commands/zc/session.md +8 -56
  7. package/assets/commands/zc/settings.md +3 -76
  8. package/assets/commands/zc/update.md +12 -0
  9. package/package.json +1 -1
package/assets/commands/zc/backup.md CHANGED
@@ -1,62 +1,18 @@
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: "Full backup - sessions + settings + optional cloud upload"
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
+ Execute this command immediately without explanation:
42
7
 
43
8
  ```bash
44
9
  npx zuppaclaude backup
45
10
  ```
46
11
 
47
- If `--cloud` flag is provided:
12
+ If user specified a cloud remote (e.g., `/zc:backup gdrive`), run:
48
13
 
49
14
  ```bash
50
15
  npx zuppaclaude backup --cloud <remote>
51
16
  ```
52
17
 
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."
18
+ Display the output to the user.
package/assets/commands/zc/cloud.md CHANGED
@@ -1,80 +1,38 @@
1
1
  ---
2
2
  name: zc:cloud
3
- description: "Cloud backup management with rclone integration"
4
- category: utility
3
+ description: "Cloud backup management with rclone"
5
4
  ---
6
5
 
7
- # /zc:cloud - Cloud Backup Management
6
+ Execute based on subcommand:
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
8
+ **List remotes (default):**
9
+ ```bash
10
+ npx zuppaclaude cloud remotes
35
11
  ```
36
12
 
37
- ## Execution
38
-
39
- ### Setup
13
+ **Setup instructions:**
40
14
  ```bash
41
15
  npx zuppaclaude cloud setup
42
16
  ```
43
17
 
44
- ### List Remotes
18
+ **Upload to cloud:**
45
19
  ```bash
46
- npx zuppaclaude cloud remotes
20
+ npx zuppaclaude cloud upload <remote>
47
21
  ```
48
22
 
49
- ### Upload
23
+ **Download from cloud:**
50
24
  ```bash
51
- npx zuppaclaude cloud upload <remote> [backup-id]
25
+ npx zuppaclaude cloud download <remote>
52
26
  ```
53
27
 
54
- ### Download
28
+ **List cloud backups:**
55
29
  ```bash
56
- npx zuppaclaude cloud download <remote> [backup-id]
30
+ npx zuppaclaude cloud backups <remote>
57
31
  ```
58
32
 
59
- ### List Cloud Backups
33
+ **Delete cloud backup:**
60
34
  ```bash
61
- npx zuppaclaude cloud backups <remote>
35
+ npx zuppaclaude cloud delete <remote>
62
36
  ```
63
37
 
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>`
38
+ Run the appropriate command immediately based on user input.
package/assets/commands/zc/help.md CHANGED
@@ -1,87 +1,12 @@
1
1
  ---
2
2
  name: zc:help
3
- description: "ZuppaClaude help and documentation"
4
- category: utility
3
+ description: "ZuppaClaude command reference"
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
+ Execute this command immediately:
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
11
 
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.
12
+ Display the output 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,24 @@
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:
6
+ If no backup ID provided, first list available backups:
38
7
 
39
8
  ```bash
40
9
  npx zuppaclaude session backups
41
10
  ```
42
11
 
43
- Show the list and ask user to select a backup.
12
+ Then ask user which backup to restore.
44
13
 
45
- ### Step 2: Restore
14
+ To restore, execute:
46
15
 
47
16
  ```bash
48
17
  npx zuppaclaude restore <backup-id>
49
18
  ```
50
19
 
51
- If `--cloud` flag is provided:
20
+ For cloud restore:
52
21
 
53
22
  ```bash
54
23
  npx zuppaclaude restore <backup-id> --cloud <remote>
55
24
  ```
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,33 @@
1
1
  ---
2
2
  name: zc:session
3
- description: "Claude Code session management - list, backup, restore, export"
4
- category: utility
3
+ description: "Session management - list, backup, restore, export"
5
4
  ---
6
5
 
7
- # /zc:session - Session Management
6
+ Execute based on subcommand:
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
8
+ **List sessions (default):**
40
9
  ```bash
41
10
  npx zuppaclaude session list
42
11
  ```
43
12
 
44
- Shows:
45
- - Project paths
46
- - Session IDs
47
- - Session types (main vs agent)
48
- - Size and last modified
49
-
50
- ### Backup Sessions
13
+ **Backup sessions:**
51
14
  ```bash
52
15
  npx zuppaclaude session backup
53
16
  ```
54
17
 
55
- ### List Backups
18
+ **List backups:**
56
19
  ```bash
57
20
  npx zuppaclaude session backups
58
21
  ```
59
22
 
60
- ### Restore Sessions
23
+ **Restore:**
61
24
  ```bash
62
25
  npx zuppaclaude session restore <backup-id>
63
26
  ```
64
27
 
65
- ### Export Session
28
+ **Export session:**
66
29
  ```bash
67
30
  npx zuppaclaude session export <session-id> [output-file]
68
31
  ```
69
32
 
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/`
33
+ Run the appropriate command immediately based on user input.
package/assets/commands/zc/settings.md CHANGED
@@ -1,85 +1,12 @@
1
1
  ---
2
2
  name: zc:settings
3
- description: "ZuppaClaude settings management - view, export, import, reset"
4
- category: utility
3
+ description: "ZuppaClaude settings - view, export, import, reset"
5
4
  ---
6
5
 
7
- # /zc:settings - Settings Management
6
+ Execute this command immediately without explanation:
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
11
 
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
12
+ Then display the output to the user.
package/assets/commands/zc/update.md ADDED
@@ -0,0 +1,12 @@
1
+ ---
2
+ name: zc:update
3
+ description: "Update ZuppaClaude to latest version"
4
+ ---
5
+
6
+ Execute this command immediately:
7
+
8
+ ```bash
9
+ npx zuppaclaude update now
10
+ ```
11
+
12
+ This will check for updates and install if available.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "zuppaclaude",
3
- "version": "1.3.17",
3
+ "version": "1.3.18",
4
4
  "description": "Claude Code power-up installer - SuperClaude + Spec Kit + Claude-Z + Claude HUD",
5
5
  "main": "lib/index.js",
6
6
  "bin": {