v0.2.0 — off-site push, scheduling, verify & selective restore

Added

• Integrity: every backup now writes a <archive>.sha256 sidecar, and a new
  claude-backup verify [--from <archive>] re-checks the gzip stream, the
  checksum and the archive's path safety (--json supported).
• Off-site copy: --remote 'cmd:<command>' (and a claude-backup push
  subcommand) push a finished backup through any command — {} is replaced by
  the archive path, otherwise it is appended. Honours CLAUDE_BACKUP_REMOTE.
  Pushes the .sha256 too; a failed push never deletes the local backup.
• Scheduling: claude-backup schedule [--daily|--weekly|--hourly] [--at HH:MM]
  installs a recurring backup via launchd (macOS) or a systemd user timer with a
  crontab fallback (Linux); --status and claude-backup unschedule manage it.
  Options after -- are passed to each scheduled run.
• Selective restore: claude-restore --only <cat[,cat…]> restores just the
  chosen categories (settings agents commands hooks skills mcp claude-md history plugins), and --list-contents shows what an archive holds.
• curl | bash install: install.sh now bootstraps its sources when piped
  (downloads the repo tarball); overridable via CCB_REPO / CCB_REF.

Changed

• _chk status helper moved into lib/common.sh (shared by doctor, verify,
  schedule status and the selective-restore listing).
• Updated bash/zsh completions and --help for the new subcommands and flags.
• Test suite expanded with verify, remote, selective-restore and schedule suites.

v0.1.1 — restore hardening & plugin recovery

Restore-focused release.

Restore improvements

• Warns when Claude Code is running before restoring (quit it first, otherwise it can overwrite ~/.claude.json from memory).
• Plugin recovery: restore now writes <backup-dir>/restore-plugins.txt with ready-to-paste /plugin marketplace add … + /reload-plugins + /plugin install … commands, derived from the restored manifests — so a new machine can bring its plugins back (plugin code isn't part of a backup).
• Faster pre-restore snapshot: symlink + tar -czh + pruning instead of a multi-GB cp -R.
• Clearer plan: overwrite: for single files (a revert) vs merge into: for directories.

Other

• README trimmed to the essentials (details live in docs/).
• CI: actions/checkout@v5 (Node 24).
• 67-test suite, ShellCheck-clean.

Full diff: v0.1.0...v0.1.1

v0.1.0 — claude-code-backup

First release. Safe, cross-platform (macOS + Linux) CLI to back up and restore Claude Code configuration.

Highlights

• claude-backup / claude-restore standalone CLIs — work even without Claude Code installed.
• Smart default scope: backs up config and conversation history (projects/), prunes large/ephemeral dirs (plugin code, caches, telemetry, venvs) at any depth, but keeps plugin manifests so you know what to reinstall. --no-history for a small backup, --full for everything.
• Safety-first restore: archive validation, symlink-escape rejection, shown plan, confirmation, automatic pre-restore backup.
• Heuristic secret scanner (--strict-secrets), progress indicator, interrupt-safe archiving.
• Claude Code plugin: /backup, /restore, /backup-status, /backup-doctor.
• Zero dependencies beyond standard bash/tar/gzip/coreutils. No network, no uploads, no telemetry.
• ShellCheck-clean, 57-test suite, CI on Ubuntu + macOS.

Install

git clone https://github.com/dberuben/claude-code-backup.git
cd claude-code-backup && ./install.sh

See the CHANGELOG for the full list.