Agent Settings Backup Script

Agent Settings Backup (asb)

A smart backup tool for AI coding agent configuration folders. Each agent type gets its own git repository, providing full version history and easy restoration.

Quick Install

Features

- Git-versioned backups: Every backup is a git commit with full history
- Multiple agent support: Claude, Codex, Cursor, Gemini, Cline, Amp, Aider, OpenCode, Factory, Windsurf, and more
- Efficient syncing: Uses rsync for incremental backups
- Easy restoration: Restore to any point in history
- Diff support: See what changed since last backup
- Restore preview & confirmation: See changes before restoring
- Config file support: Persistent settings in ~/.config/asb/config
- Export/import archives: Move backups between machines
- Shell completion: Bash, Zsh, and Fish completions
- Dry-run mode: Preview operations without changes
- Scheduled backups: Install cron or systemd timers with asb schedule
- Hooks: Run scripts before/after backup and restore
- Named tags: Label important backups for easy reference
- Backup statistics: See size, commit count, and activity metrics
- Auto-discovery: Scan for new AI coding agents
- Structured output: Machine-readable output for all commands (JSON/TOON)

New in v0.3

- Backup tags: Name important backups with asb tag claude v1.0
- Restore from tags: Use asb restore claude v1.0 instead of commit hashes
- Statistics: View backup stats with asb stats and asb stats
- Auto-discovery: Find new AI agents with asb discover
- Custom agents: Add discovered agents to your backup rotation
- Structured output: All commands support --json (and --format toon) for machine-readable output

New in v0.2

- Dry-run mode: Preview changes with --dry-run or -n
- Restore confirmation: See exactly what will change before restoring
- Configuration…