claude-code-backup 1.0.0 → 1.0.1

package/README.md

@@ -54,7 +54,7 @@ None of this is synced by Anthropic. A new machine, an accidental `rm -rf ~/.cla
 npm install -g claude-code-backup
 ```
 
-Installs the `claude-backup` command globally.
+Installs the `claude-code-backup` command globally.
 
 ---
 
@@ -62,16 +62,16 @@ Installs the `claude-backup` command globally.
 
 ```bash
 # 1. Run the setup wizard
-claude-backup init
+claude-code-backup init
 
 # 2. Do your first manual backup
-claude-backup push
+claude-code-backup push
 
 # 3. Install the background service (auto-syncs on every login)
-claude-backup service install
+claude-code-backup service install
 
 # 4. Check everything is working
-claude-backup status
+claude-code-backup status
 ```
 
 That's it. From this point the watcher runs silently in the background and pushes every change to your private GitHub repo.
@@ -81,20 +81,20 @@ That's it. From this point the watcher runs silently in the background and pushe
 ## Setup Wizard (`init`)
 
 ```
-$ claude-backup init
+$ claude-code-backup init
 
 Claude Backup — Setup Wizard
 
 Step 1 of 4 — GitHub Personal Access Token
 
-  claude-backup needs a PAT with "repo" scope to create
+  claude-code-backup needs a PAT with "repo" scope to create
   and push to a private GitHub repository on your behalf.
 
   Create your token here:
   https://github.com/settings/tokens/new
 
   Instructions:
-  1. Note name → e.g. "claude-backup"
+  1. Note name → e.g. "claude-code-backup"
   2. Expiration → your preference (No expiration is fine)
   3. Scopes → tick  repo  (the top-level checkbox)
   4. Click "Generate token" and copy the value
@@ -102,7 +102,7 @@ Step 1 of 4 — GitHub Personal Access Token
 ? Paste your GitHub PAT: ****
 
 Step 2 of 4 — Repository & Branch
-? GitHub repo name (e.g. yourname/claude-backup): yourname/claude-backup
+? GitHub repo name (e.g. yourname/claude-code-backup): yourname/claude-code-backup
 ? Branch name: main
 
 Step 3 of 4 — Watched Directories & Filters
@@ -114,37 +114,37 @@ Step 4 of 4 — Project CLAUDE.md Files
 ? Project root directories with CLAUDE.md (blank to skip): /Users/you/projects/my-app
 
 ✔ Config saved
-✔ Created: github.com/yourname/claude-backup
+✔ Created: github.com/yourname/claude-code-backup
 ✔ Repo cloned
 ✔ GitHub setup complete
 ```
 
 The wizard:
 - Creates the GitHub repo as **private** if it doesn't exist
-- Clones it locally to `~/.config/claude-backup/repo/`
+- Clones it locally to `~/.config/claude-code-backup/repo/`
 - Writes a detailed `README.md` into your backup repo documenting the structure and restore process
 
 ---
 
 ## Command Reference
 
-### `claude-backup init`
+### `claude-code-backup init`
 
 Interactive setup wizard. Run once to configure, or again at any time to update settings.
 
 ```bash
-claude-backup init
+claude-code-backup init
 ```
 
 ---
 
-### `claude-backup push`
+### `claude-code-backup push`
 
 Manually push a backup to GitHub right now.
 
 ```bash
-claude-backup push                          # auto commit message: "backup: <ISO timestamp>"
-claude-backup push -m "before OS upgrade"  # custom commit message
+claude-code-backup push                          # auto commit message: "backup: <ISO timestamp>"
+claude-code-backup push -m "before OS upgrade"  # custom commit message
 ```
 
 What it does:
@@ -158,17 +158,17 @@ What it does:
 
 ---
 
-### `claude-backup pull`
+### `claude-code-backup pull`
 
 Restore files from your GitHub backup.
 
 ```bash
-claude-backup pull                # restore the latest backup
-claude-backup pull --history      # browse commits, pick a specific version
-claude-backup pull --dry-run      # preview what would change — no files written
+claude-code-backup pull                # restore the latest backup
+claude-code-backup pull --history      # browse commits, pick a specific version
+claude-code-backup pull --dry-run      # preview what would change — no files written
 ```
 
-**Safety:** before touching any file, `pull` creates a timestamped snapshot of your current state at `~/.config/claude-backup/pre-restore-<timestamp>/`. You can always manually recover from there.
+**Safety:** before touching any file, `pull` creates a timestamped snapshot of your current state at `~/.config/claude-code-backup/pre-restore-<timestamp>/`. You can always manually recover from there.
 
 Restore works on:
 - **Same machine** — recover from accidental deletion
@@ -177,13 +177,13 @@ Restore works on:
 
 ---
 
-### `claude-backup watch`
+### `claude-code-backup watch`
 
 Start the real-time file watcher. Normally this runs via the launchd service — use this command to run it manually in the foreground.
 
 ```bash
-claude-backup watch                   # file watcher (recommended)
-claude-backup watch --interval 5      # poll every 5 minutes instead
+claude-code-backup watch                   # file watcher (recommended)
+claude-code-backup watch --interval 5      # poll every 5 minutes instead
 ```
 
 The watcher:
@@ -194,12 +194,12 @@ The watcher:
 
 ---
 
-### `claude-backup status`
+### `claude-code-backup status`
 
 Show the current state of your backup.
 
 ```
-$ claude-backup status
+$ claude-code-backup status
 
 Claude Backup Status
 
@@ -211,7 +211,7 @@ Project CLAUDE.md dirs:
   /Users/you/projects/my-app
 CLAUDE.md files: 1
 
-GitHub: yourname/claude-backup  [main]
+GitHub: yourname/claude-code-backup  [main]
 Last backup:  2026-05-18 10:34:22
 Commit:       a3f9c1d  backup: 2026-05-18T10:34:22.000Z
 Sync status:  Up to date
@@ -221,43 +221,43 @@ Auto-sync service: running (PID 4821)
 
 ---
 
-### `claude-backup service <action>`
+### `claude-code-backup service <action>`
 
 Manage the macOS launchd background service.
 
 ```bash
-claude-backup service install     # write plist, load service, start immediately
-claude-backup service uninstall   # stop service, remove plist
-claude-backup service status      # check if running, show PID
-claude-backup service logs        # tail the watcher log in real-time
+claude-code-backup service install     # write plist, load service, start immediately
+claude-code-backup service uninstall   # stop service, remove plist
+claude-code-backup service status      # check if running, show PID
+claude-code-backup service logs        # tail the watcher log in real-time
 ```
 
 The service plist is installed at:
 
 ```
-~/Library/LaunchAgents/com.claude-backup.watch.plist
+~/Library/LaunchAgents/com.claude-code-backup.watch.plist
 ```
 
 Key behaviour:
 - `RunAtLoad: true` — starts immediately when installed, and on every login
 - `KeepAlive: true` — launchd restarts the watcher automatically if it crashes
 - `ThrottleInterval: 10` — prevents restart storms
-- Logs go to `~/.config/claude-backup/watch.log`
-- Errors go to `~/.config/claude-backup/watch.error.log`
+- Logs go to `~/.config/claude-code-backup/watch.log`
+- Errors go to `~/.config/claude-code-backup/watch.error.log`
 
 ---
 
-### `claude-backup config <action>`
+### `claude-code-backup config <action>`
 
 View or modify configuration without re-running `init`.
 
 ```bash
-claude-backup config show                             # print config (PAT masked)
-claude-backup config set auto_sync.debounce_ms 3000   # change a value
-claude-backup config add-dir <path>                   # fully mirror an extra directory
-claude-backup config remove-dir <path>
-claude-backup config add-project <path>               # back up only CLAUDE.md from a project root
-claude-backup config remove-project <path>
+claude-code-backup config show                             # print config (PAT masked)
+claude-code-backup config set auto_sync.debounce_ms 3000   # change a value
+claude-code-backup config add-dir <path>                   # fully mirror an extra directory
+claude-code-backup config remove-dir <path>
+claude-code-backup config add-project <path>               # back up only CLAUDE.md from a project root
+claude-code-backup config remove-project <path>
 ```
 
 ---
@@ -271,7 +271,7 @@ Claude Code lets you put a `CLAUDE.md` file at any project root. Claude reads it
 ```bash
 # Add a project during init (Step 4)
 # Or add it later:
-claude-backup config add-project /Users/you/projects/my-app
+claude-code-backup config add-project /Users/you/projects/my-app
 ```
 
 In the backup repo, it appears as:
@@ -315,7 +315,7 @@ Every push is a Git commit — you get full history, diffs, and can restore any
 
 ## Configuration Reference
 
-Config file: `~/.config/claude-backup/config.json` (chmod 600)
+Config file: `~/.config/claude-code-backup/config.json` (chmod 600)
 
 | Key | Type | Default | Description |
 |---|---|---|---|
@@ -329,7 +329,7 @@ Config file: `~/.config/claude-backup/config.json` (chmod 600)
 
 Default excludes: `settings.local.json`, `*.log`, `.DS_Store`
 
-Local repo clone: `~/.config/claude-backup/repo/`
+Local repo clone: `~/.config/claude-code-backup/repo/`
 
 ---
 
@@ -338,22 +338,22 @@ Local repo clone: `~/.config/claude-backup/repo/`
 ### After accidental deletion (same machine)
 
 ```bash
-claude-backup pull
+claude-code-backup pull
 ```
 
 ### Setting up a new machine
 
 ```bash
 npm install -g claude-code-backup
-claude-backup init      # use same repo name, generate a new PAT
-claude-backup pull
-claude-backup service install
+claude-code-backup init      # use same repo name, generate a new PAT
+claude-code-backup pull
+claude-code-backup service install
 ```
 
 ### Restoring a specific historical version
 
 ```bash
-claude-backup pull --history
+claude-code-backup pull --history
 ```
 
 Shows a list of all commits — pick the one you want by timestamp and message.
@@ -363,7 +363,7 @@ Shows a list of all commits — pick the one you want by timestamp and message.
 Every `pull` creates a safety snapshot first:
 
 ```bash
-ls ~/.config/claude-backup/pre-restore-*/
+ls ~/.config/claude-code-backup/pre-restore-*/
 # Copy what you need back manually
 ```
 
@@ -371,34 +371,34 @@ ls ~/.config/claude-backup/pre-restore-*/
 
 ## Troubleshooting
 
-**"Not configured. Run: claude-backup init"**
-Config file is missing. Re-run `claude-backup init`.
+**"Not configured. Run: claude-code-backup init"**
+Config file is missing. Re-run `claude-code-backup init`.
 
 **Push fails with 401 or authentication error**
 Your PAT may have expired. Generate a new one and update:
 ```bash
-claude-backup config set github.pat <new-token>
-claude-backup service install   # restart the watcher with the new token
+claude-code-backup config set github.pat <new-token>
+claude-code-backup service install   # restart the watcher with the new token
 ```
 
 **Service shows "loaded but not running"**
 ```bash
-claude-backup service logs
-cat ~/.config/claude-backup/watch.error.log
-claude-backup service install   # reinstall to reset
+claude-code-backup service logs
+cat ~/.config/claude-code-backup/watch.error.log
+claude-code-backup service install   # reinstall to reset
 ```
 
 **Changes not being detected**
 Confirm the directory is watched:
 ```bash
-claude-backup config show
-claude-backup config add-dir /missing/path
+claude-code-backup config show
+claude-code-backup config add-dir /missing/path
 ```
 
 **Want to watch a project directory without backing up all source code**
 Use `add-project` instead of `add-dir` — it only collects the `CLAUDE.md` file:
 ```bash
-claude-backup config add-project /path/to/project
+claude-code-backup config add-project /path/to/project
 ```
 
 ---
@@ -417,7 +417,7 @@ claude-backup config add-project /path/to/project
   └─ grab CLAUDE.md from claude_md_dirs
       │
       ▼
-  copy to ~/.config/claude-backup/repo/
+  copy to ~/.config/claude-code-backup/repo/
   write backup-manifest.json
   write README.md
       │
@@ -425,7 +425,7 @@ claude-backup config add-project /path/to/project
   git add -A → git commit → git push
       │
       ▼
-  github.com/you/claude-backup (private)
+  github.com/you/claude-code-backup (private)
 ```
 
 ---
@@ -438,7 +438,7 @@ Contributions are welcome. Please open an issue first for any significant change
 git clone https://github.com/mafzal9/claude-code-backup.git
 cd claude-code-backup
 npm install
-node bin/claude-backup.js --help
+node bin/claude-code-backup.js --help
 ```
 
 Ideas for future contributions:

package/bin/{claude-backup.js → claude-code-backup.js}

@@ -10,9 +10,9 @@ import { runService } from '../src/commands/service.js';
 import { runConfig } from '../src/commands/config-cmd.js';
 
 program
-  .name('claude-backup')
+  .name('claude-code-backup')
   .description('Backup and auto-sync Claude Code memory and settings to GitHub')
-  .version('1.0.0');
+  .version('1.0.1');
 
 program
   .command('init')

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "claude-code-backup",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Backup and auto-sync Claude Code memory, settings, and CLAUDE.md files to a private GitHub repo — with real-time file watching and macOS launchd auto-start",
   "type": "module",
   "bin": {
-    "claude-backup": "./bin/claude-backup.js"
+    "claude-code-backup": "bin/claude-code-backup.js"
   },
   "files": [
-    "bin/",
+    "bin/claude-code-backup.js",
     "src/",
     "README.md",
     "LICENSE"
@@ -37,7 +37,7 @@
   "homepage": "https://github.com/mafzal9/claude-code-backup#readme",
   "repository": {
     "type": "git",
-    "url": "https://github.com/mafzal9/claude-code-backup.git"
+    "url": "git+https://github.com/mafzal9/claude-code-backup.git"
   },
   "bugs": {
     "url": "https://github.com/mafzal9/claude-code-backup/issues"

package/src/backends/github.js

@@ -16,8 +16,8 @@ function repoGit() {
 }
 
 async function configureGit(g) {
-  await g.addConfig('user.email', 'claude-backup@local', false, 'local');
-  await g.addConfig('user.name', 'claude-backup', false, 'local');
+  await g.addConfig('user.email', 'claude-code-backup@local', false, 'local');
+  await g.addConfig('user.name', 'claude-code-backup', false, 'local');
 }
 
 async function syncRemote(g, config) {
@@ -36,11 +36,11 @@ function buildReadme(config) {
   const claudeMdDirs = config.claude_md_dirs || [];
   const claudeMdList = claudeMdDirs.length
     ? claudeMdDirs.map(d => `- \`${d}/CLAUDE.md\``).join('\n')
-    : '_No project CLAUDE.md dirs configured yet._\n\nAdd one with: `claude-backup config add-project /path/to/project`';
+    : '_No project CLAUDE.md dirs configured yet._\n\nAdd one with: `claude-code-backup config add-project /path/to/project`';
 
   return `# Claude Code Backup
 
-> Auto-synced by [claude-backup](https://www.npmjs.com/package/claude-backup) — a CLI tool that watches your Claude Code data directories and commits every change to this private repo.
+> Auto-synced by [claude-code-backup](https://www.npmjs.com/package/claude-code-backup) — a CLI tool that watches your Claude Code data directories and commits every change to this private repo.
 
 **Repo:** \`${config.github.repo}\` · **Branch:** \`${config.github.branch}\` · **Last setup:** ${now}
 
@@ -81,8 +81,8 @@ ${claudeMdList}
 
 Add or remove projects at any time:
 \`\`\`bash
-claude-backup config add-project /path/to/project
-claude-backup config remove-project /path/to/project
+claude-code-backup config add-project /path/to/project
+claude-code-backup config remove-project /path/to/project
 \`\`\`
 
 ---
@@ -141,7 +141,7 @@ These files are the most valuable thing to back up because they accumulate over
 ## Installation
 
 \`\`\`bash
-npm install -g claude-backup
+npm install -g claude-code-backup
 \`\`\`
 
 Requires Node.js 18 or later.
@@ -150,12 +150,12 @@ Requires Node.js 18 or later.
 
 ## Command Reference
 
-### \`claude-backup init\`
+### \`claude-code-backup init\`
 
 Interactive setup wizard. Run this once (or again to reconfigure).
 
 \`\`\`
-$ claude-backup init
+$ claude-code-backup init
 
 Step 1 of 3 — GitHub Personal Access Token
   Create your token here: https://github.com/settings/tokens/new
@@ -164,7 +164,7 @@ Step 1 of 3 — GitHub Personal Access Token
 ? Paste your GitHub PAT: ****
 
 Step 2 of 3 — Repository & Branch
-? GitHub repo name: yourname/claude-backup
+? GitHub repo name: yourname/claude-code-backup
 ? Branch name: main
 
 Step 3 of 3 — Watched Directories & Filters
@@ -174,20 +174,20 @@ Step 3 of 3 — Watched Directories & Filters
 \`\`\`
 
 What it does:
-- Saves config to \`~/.config/claude-backup/config.json\` (chmod 600)
+- Saves config to \`~/.config/claude-code-backup/config.json\` (chmod 600)
 - Creates this GitHub repo as private if it doesn't exist
-- Clones the repo locally to \`~/.config/claude-backup/repo/\`
+- Clones the repo locally to \`~/.config/claude-code-backup/repo/\`
 - Writes this README into the repo
 
 ---
 
-### \`claude-backup push\`
+### \`claude-code-backup push\`
 
 Manually push a backup right now.
 
 \`\`\`bash
-claude-backup push                        # auto commit message: "backup: <ISO timestamp>"
-claude-backup push -m "before upgrade"   # custom commit message
+claude-code-backup push                        # auto commit message: "backup: <ISO timestamp>"
+claude-code-backup push -m "before upgrade"   # custom commit message
 \`\`\`
 
 What it does:
@@ -199,17 +199,17 @@ What it does:
 
 ---
 
-### \`claude-backup pull\`
+### \`claude-code-backup pull\`
 
 Restore files from this repo back to their original locations.
 
 \`\`\`bash
-claude-backup pull                  # restore the latest backup
-claude-backup pull --history        # browse commits, pick a specific version
-claude-backup pull --dry-run        # preview what would be restored — no files written
+claude-code-backup pull                  # restore the latest backup
+claude-code-backup pull --history        # browse commits, pick a specific version
+claude-code-backup pull --dry-run        # preview what would be restored — no files written
 \`\`\`
 
-**Safety:** before writing anything, \`pull\` creates a timestamped snapshot of your current state at \`~/.config/claude-backup/pre-restore-<timestamp>/\` so you can always undo.
+**Safety:** before writing anything, \`pull\` creates a timestamped snapshot of your current state at \`~/.config/claude-code-backup/pre-restore-<timestamp>/\` so you can always undo.
 
 Restore flow:
 1. \`git fetch origin\` to get latest from GitHub
@@ -221,13 +221,13 @@ Restore flow:
 
 ---
 
-### \`claude-backup watch\`
+### \`claude-code-backup watch\`
 
 Start the real-time file watcher. Detects changes in watched directories and auto-pushes to GitHub.
 
 \`\`\`bash
-claude-backup watch                    # real-time via chokidar (recommended)
-claude-backup watch --interval 5       # poll every 5 minutes instead
+claude-code-backup watch                    # real-time via chokidar (recommended)
+claude-code-backup watch --interval 5       # poll every 5 minutes instead
 \`\`\`
 
 The watcher:
@@ -241,12 +241,12 @@ In normal use you don't run this directly — the launchd service runs it for yo
 
 ---
 
-### \`claude-backup status\`
+### \`claude-code-backup status\`
 
 Show a summary of the current state.
 
 \`\`\`
-$ claude-backup status
+$ claude-code-backup status
 
 Claude Backup Status
 
@@ -255,7 +255,7 @@ Watched dirs:
 
 Files tracked: 42
 
-GitHub: yourname/claude-backup  [main]
+GitHub: yourname/claude-code-backup  [main]
 Last backup:  2026-05-18 10:34:22
 Commit:       a3f9c1d  backup: 2026-05-18T10:34:22.000Z
 Sync status:  Up to date
@@ -265,40 +265,40 @@ Auto-sync service: running (PID 1234)
 
 ---
 
-### \`claude-backup service <action>\`
+### \`claude-code-backup service <action>\`
 
 Manage the macOS launchd background service that runs the file watcher automatically on every login.
 
 \`\`\`bash
-claude-backup service install     # write plist + load service now
-claude-backup service uninstall   # stop service + remove plist
-claude-backup service status      # check if running, show PID
-claude-backup service logs        # tail the watcher log in real-time
+claude-code-backup service install     # write plist + load service now
+claude-code-backup service uninstall   # stop service + remove plist
+claude-code-backup service status      # check if running, show PID
+claude-code-backup service logs        # tail the watcher log in real-time
 \`\`\`
 
 The service plist is installed at:
 \`\`\`
-~/Library/LaunchAgents/com.claude-backup.watch.plist
+~/Library/LaunchAgents/com.claude-code-backup.watch.plist
 \`\`\`
 
 Key plist settings:
 - \`RunAtLoad: true\` — starts when the service is loaded (immediately on install)
 - \`KeepAlive: true\` — launchd restarts the watcher if it ever crashes
 - \`ThrottleInterval: 10\` — prevents rapid restart loops if something goes wrong
-- Stdout → \`~/.config/claude-backup/watch.log\`
-- Stderr → \`~/.config/claude-backup/watch.error.log\`
+- Stdout → \`~/.config/claude-code-backup/watch.log\`
+- Stderr → \`~/.config/claude-code-backup/watch.error.log\`
 
 ---
 
-### \`claude-backup config <action>\`
+### \`claude-code-backup config <action>\`
 
 View or modify configuration without re-running \`init\`.
 
 \`\`\`bash
-claude-backup config show                            # print current config (PAT masked)
-claude-backup config set auto_sync.debounce_ms 3000  # change a value
-claude-backup config add-dir /path/to/project        # watch an extra directory
-claude-backup config remove-dir /path/to/project     # stop watching a directory
+claude-code-backup config show                            # print current config (PAT masked)
+claude-code-backup config set auto_sync.debounce_ms 3000  # change a value
+claude-code-backup config add-dir /path/to/project        # watch an extra directory
+claude-code-backup config remove-dir /path/to/project     # stop watching a directory
 \`\`\`
 
 Nested keys use dot notation. Values are auto-cast (numbers, booleans).
@@ -310,7 +310,7 @@ Nested keys use dot notation. Values are auto-cast (numbers, booleans).
 After running \`init\` and \`push\`, install the background service:
 
 \`\`\`bash
-claude-backup service install
+claude-code-backup service install
 \`\`\`
 
 From this point on:
@@ -322,8 +322,8 @@ From this point on:
 To verify it's working:
 
 \`\`\`bash
-claude-backup status                # should show "running (PID ...)"
-claude-backup service logs          # live log of every sync
+claude-code-backup status                # should show "running (PID ...)"
+claude-code-backup service logs          # live log of every sync
 \`\`\`
 
 ---
@@ -333,7 +333,7 @@ claude-backup service logs          # live log of every sync
 ### Restore to the same machine (after accidental deletion)
 
 \`\`\`bash
-claude-backup pull
+claude-code-backup pull
 \`\`\`
 
 Confirm the preview, and your files are back.
@@ -341,25 +341,25 @@ Confirm the preview, and your files are back.
 ### Restore to a new machine
 
 \`\`\`bash
-# 1. Install Node.js (18+) and claude-backup
-npm install -g claude-backup
+# 1. Install Node.js (18+) and claude-code-backup
+npm install -g claude-code-backup
 
 # 2. Run init with the same GitHub repo
-claude-backup init
-#    → Same repo name (yourname/claude-backup)
+claude-code-backup init
+#    → Same repo name (yourname/claude-code-backup)
 #    → New GitHub PAT (generate a new one)
 
 # 3. Pull the latest backup
-claude-backup pull
+claude-code-backup pull
 
 # 4. Install the background service on the new machine
-claude-backup service install
+claude-code-backup service install
 \`\`\`
 
 ### Restore a specific historical version
 
 \`\`\`bash
-claude-backup pull --history
+claude-code-backup pull --history
 \`\`\`
 
 This shows a list of all commits in this repo. Select the one you want — the timestamp and commit message help identify when each backup was taken.
@@ -368,7 +368,7 @@ This shows a list of all commits in this repo. Select the one you want — the t
 
 ## Configuration Reference
 
-Config file location: \`~/.config/claude-backup/config.json\`
+Config file location: \`~/.config/claude-code-backup/config.json\`
 
 | Key | Type | Default | Description |
 |---|---|---|---|
@@ -383,57 +383,57 @@ Config file location: \`~/.config/claude-backup/config.json\`
 
 Default excludes: \`settings.local.json\`, \`*.log\`, \`.DS_Store\`
 
-The local repo clone lives at: \`~/.config/claude-backup/repo/\`
+The local repo clone lives at: \`~/.config/claude-code-backup/repo/\`
 
 ---
 
 ## Security Notes
 
 - This repo is **private** — only you and anyone you explicitly invite can see it
-- Your GitHub PAT is stored locally at \`~/.config/claude-backup/config.json\` with \`chmod 600\` (owner-read only)
+- Your GitHub PAT is stored locally at \`~/.config/claude-code-backup/config.json\` with \`chmod 600\` (owner-read only)
 - The PAT is never committed to this repo
 - \`settings.local.json\` is excluded by default because it may contain machine-specific or sensitive values
-- If you ever rotate your PAT, run \`claude-backup config set github.pat <new-token>\` then \`claude-backup service install\` to restart the watcher with the new token
+- If you ever rotate your PAT, run \`claude-code-backup config set github.pat <new-token>\` then \`claude-code-backup service install\` to restart the watcher with the new token
 
 ---
 
 ## Troubleshooting
 
-**"Not configured. Run: claude-backup init"**
-The config file is missing or incomplete. Re-run \`claude-backup init\`.
+**"Not configured. Run: claude-code-backup init"**
+The config file is missing or incomplete. Re-run \`claude-code-backup init\`.
 
 **Push fails with authentication error**
 Your PAT may have expired or been revoked. Generate a new one at
 https://github.com/settings/tokens/new and run:
 \`\`\`bash
-claude-backup config set github.pat <new-token>
+claude-code-backup config set github.pat <new-token>
 \`\`\`
 
 **Service shows "loaded but not running"**
 Check the error log:
 \`\`\`bash
-claude-backup service logs
-cat ~/.config/claude-backup/watch.error.log
+claude-code-backup service logs
+cat ~/.config/claude-code-backup/watch.error.log
 \`\`\`
-Then reinstall the service: \`claude-backup service install\`
+Then reinstall the service: \`claude-code-backup service install\`
 
 **Files not being detected by the watcher**
 Confirm the directory is in your watch list:
 \`\`\`bash
-claude-backup config show
-claude-backup config add-dir /path/to/missing/dir
+claude-code-backup config show
+claude-code-backup config add-dir /path/to/missing/dir
 \`\`\`
 
 **Restore wrote wrong files / I want to undo**
 Every restore creates a safety snapshot before touching anything:
 \`\`\`bash
-ls ~/.config/claude-backup/pre-restore-*/
+ls ~/.config/claude-code-backup/pre-restore-*/
 \`\`\`
 Copy the files you need back from there manually.
 
 ---
 
-*This README is auto-generated by \`claude-backup init\` and reflects the configuration at setup time.*
+*This README is auto-generated by \`claude-code-backup init\` and reflects the configuration at setup time.*
 `;
 }
 
@@ -479,7 +479,7 @@ export async function ensureRepo(config) {
 
 export async function push(config, commitMessage) {
   if (!existsSync(REPO_DIR)) {
-    log.error('Repo not set up. Run: claude-backup init');
+    log.error('Repo not set up. Run: claude-code-backup init');
     process.exit(1);
   }
 
@@ -559,7 +559,7 @@ export async function getHistory(config, limit = 15) {
 
 export async function fetchForRestore(config, ref) {
   if (!existsSync(REPO_DIR)) {
-    log.error('Repo not set up. Run: claude-backup init');
+    log.error('Repo not set up. Run: claude-code-backup init');
     process.exit(1);
   }
 

package/src/commands/config-cmd.js

@@ -26,7 +26,7 @@ export function runConfig(action, key, value) {
 function showConfig() {
   const config = loadConfig();
   if (!config) {
-    log.warn('Not configured yet. Run: claude-backup init');
+    log.warn('Not configured yet. Run: claude-code-backup init');
     return;
   }
   const safe = JSON.parse(JSON.stringify(config));
@@ -40,8 +40,8 @@ function showConfig() {
 
 function setConfig(key, value) {
   if (!key || value === undefined) {
-    log.error('Usage: claude-backup config set <key> <value>');
-    log.dim('Example: claude-backup config set auto_sync.debounce_ms 3000');
+    log.error('Usage: claude-code-backup config set <key> <value>');
+    log.dim('Example: claude-code-backup config set auto_sync.debounce_ms 3000');
     process.exit(1);
   }
   const config = requireConfig();
@@ -63,7 +63,7 @@ function setConfig(key, value) {
 
 function addDir(dirPath) {
   if (!dirPath) {
-    log.error('Usage: claude-backup config add-dir <path>');
+    log.error('Usage: claude-code-backup config add-dir <path>');
     process.exit(1);
   }
   const config = requireConfig();
@@ -79,7 +79,7 @@ function addDir(dirPath) {
 
 function removeDir(dirPath) {
   if (!dirPath) {
-    log.error('Usage: claude-backup config remove-dir <path>');
+    log.error('Usage: claude-code-backup config remove-dir <path>');
     process.exit(1);
   }
   const config = requireConfig();
@@ -98,7 +98,7 @@ function removeDir(dirPath) {
 
 function addProject(dirPath) {
   if (!dirPath) {
-    log.error('Usage: claude-backup config add-project <project-root-path>');
+    log.error('Usage: claude-code-backup config add-project <project-root-path>');
     log.dim('Only the CLAUDE.md file at that path will be backed up.');
     process.exit(1);
   }
@@ -117,7 +117,7 @@ function addProject(dirPath) {
 
 function removeProject(dirPath) {
   if (!dirPath) {
-    log.error('Usage: claude-backup config remove-project <project-root-path>');
+    log.error('Usage: claude-code-backup config remove-project <project-root-path>');
     process.exit(1);
   }
   const config = requireConfig();

package/src/commands/init.js

@@ -13,12 +13,12 @@ export async function runInit() {
 
   // ── Step 1: GitHub PAT ───────────────────────────────────────────────────
   console.log(chalk.bold.underline('Step 1 of 4 — GitHub Personal Access Token') + '\n');
-  console.log('claude-backup needs a PAT with ' + chalk.cyan('"repo"') + ' scope to create');
+  console.log('claude-code-backup needs a PAT with ' + chalk.cyan('"repo"') + ' scope to create');
   console.log('and push to a private GitHub repository on your behalf.\n');
   console.log(chalk.bold('  Create your token here:'));
   console.log('  ' + chalk.underline.blue('https://github.com/settings/tokens/new') + '\n');
   console.log(chalk.dim('  Instructions:'));
-  console.log(chalk.dim('  1. Note name → e.g. "claude-backup"'));
+  console.log(chalk.dim('  1. Note name → e.g. "claude-code-backup"'));
   console.log(chalk.dim('  2. Expiration → your preference (No expiration is fine)'));
   console.log(chalk.dim('  3. Scopes → tick  ') + chalk.cyan('repo') + chalk.dim('  (the top-level checkbox covers everything needed)'));
   console.log(chalk.dim('  4. Click "Generate token" and copy the value\n'));
@@ -44,7 +44,7 @@ export async function runInit() {
     {
       type: 'input',
       name: 'repo',
-      message: 'GitHub repo name (e.g. yourname/claude-backup):',
+      message: 'GitHub repo name (e.g. yourname/claude-code-backup):',
       default: existing?.github?.repo || '',
       validate: v =>
         /^[\w.-]+\/[\w.-]+$/.test(v.trim()) || 'Format must be owner/repo',
@@ -122,14 +122,14 @@ export async function runInit() {
   };
 
   saveConfig(config);
-  log.success('Config saved  (~/.config/claude-backup/config.json, chmod 600)');
+  log.success('Config saved  (~/.config/claude-code-backup/config.json, chmod 600)');
 
   try {
     await ensureRepo(config);
     log.success('GitHub setup complete\n');
     log.info('Next steps:');
-    log.dim('  claude-backup push                — do your first backup now');
-    log.dim('  claude-backup service install     — enable auto-sync on login');
+    log.dim('  claude-code-backup push                — do your first backup now');
+    log.dim('  claude-code-backup service install     — enable auto-sync on login');
   } catch (err) {
     log.error(`GitHub setup failed: ${err.message}`);
     if (process.env.DEBUG) console.error(err);

package/src/commands/pull.js

@@ -59,7 +59,7 @@ export async function runPull(options) {
     spin.stop();
 
     if (history.length === 0) {
-      log.warn('No commits found. Run: claude-backup push first');
+      log.warn('No commits found. Run: claude-code-backup push first');
       return;
     }
 

package/src/commands/service.js

@@ -63,7 +63,7 @@ async function unloadService() {
 
 async function installService() {
   const nodePath = process.execPath;   // path to the node binary running this script
-  const scriptPath = process.argv[1];  // absolute path to claude-backup.js
+  const scriptPath = process.argv[1];  // absolute path to claude-code-backup.js
 
   const plist = buildPlist(nodePath, scriptPath);
   writeFileSync(LAUNCHD_PLIST, plist, 'utf8');
@@ -106,7 +106,7 @@ async function uninstallService() {
 async function serviceStatus() {
   if (!existsSync(LAUNCHD_PLIST)) {
     log.warn('Service is not installed');
-    log.dim('Run: claude-backup service install');
+    log.dim('Run: claude-code-backup service install');
     return;
   }
 

package/src/commands/status.js

@@ -65,7 +65,7 @@ export async function runStatus() {
       console.log(`${chalk.bold('Sync status:')}  ${chalk.green('Up to date')}`);
     }
   } else {
-    console.log(chalk.dim('  No backups yet. Run: claude-backup push'));
+    console.log(chalk.dim('  No backups yet. Run: claude-code-backup push'));
   }
 
   // Launchd service
@@ -73,7 +73,7 @@ export async function runStatus() {
   const svcColor = svc.startsWith('running') ? chalk.green : chalk.yellow;
   console.log(`\n${chalk.bold('Auto-sync service:')} ${svcColor(svc)}`);
   if (!svc.startsWith('running')) {
-    console.log(chalk.dim('  Run: claude-backup service install'));
+    console.log(chalk.dim('  Run: claude-code-backup service install'));
   }
 
   console.log('');

package/src/core/config.js

@@ -2,15 +2,15 @@ import { homedir } from 'os';
 import { join } from 'path';
 import { readFileSync, writeFileSync, mkdirSync, existsSync, chmodSync } from 'fs';
 
-export const CONFIG_DIR = join(homedir(), '.config', 'claude-backup');
+export const CONFIG_DIR = join(homedir(), '.config', 'claude-code-backup');
 export const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
 export const REPO_DIR = join(CONFIG_DIR, 'repo');
 export const LOG_FILE = join(CONFIG_DIR, 'watch.log');
 export const ERROR_LOG_FILE = join(CONFIG_DIR, 'watch.error.log');
 export const LAUNCHD_PLIST = join(
-  homedir(), 'Library', 'LaunchAgents', 'com.claude-backup.watch.plist'
+  homedir(), 'Library', 'LaunchAgents', 'com.claude-code-backup.watch.plist'
 );
-export const LAUNCHD_LABEL = 'com.claude-backup.watch';
+export const LAUNCHD_LABEL = 'com.claude-code-backup.watch';
 
 export function ensureConfigDir() {
   mkdirSync(CONFIG_DIR, { recursive: true });
@@ -34,7 +34,7 @@ export function saveConfig(config) {
 export function requireConfig() {
   const config = loadConfig();
   if (!config || !config.github?.pat || !config.github?.repo) {
-    console.error('Not configured. Run: claude-backup init');
+    console.error('Not configured. Run: claude-code-backup init');
     process.exit(1);
   }
   return config;