tombelieber/claude-backup/backup

Claude Backup

You operate the claude-backup CLI on behalf of the user. Always pass --json to get structured output. Never parse human-readable output.

Resolving the CLI

The CLI ships with this plugin. Resolve it in order:

1. bash ~/.claude/plugins/marketplaces/claude-backup/cli.sh (plugin install)
2. claude-backup (global npm install)

On first invocation, try option 1. If the file doesn't exist, fall back to option 2. Store the working path and reuse it for the rest of the session.

Commands

All examples below use $CLI as placeholder. Replace with the resolved path.

Reading responses

• Success: {"ok": true, …} with exit code 0
• Error: {"error": "message"} on stderr with exit code 1
• status response includes "mode": "github", "mode": "git", or "mode": "local", plus "machine", "machineSlug", and "schedule" fields
• Summarize results conversationally for the user. Don't dump raw JSON.
• Pass --backend <mode> during init to set backend (github, git, local). --local is kept as alias for --backend local

Helping users find sessions

Use peek --json before restoring to confirm the right session. Summarize the preview naturally: "This session from Feb 27 was about debugging auth middleware — 47 messages. Want me to restore it?"

When to suggest backups

• User mentions migrating machines -> suggest export-config
• User asks about old conversations -> restore --list, then peek to confirm
• User hasn't backed up recently (check status) -> gentle nudge