agent_settings_backup_script

# Agent Settings Backup (asb)

<div align="center">
  <img src="asb_illustration.webp" alt="asb - Smart backup tool for AI coding agent configurations">
</div>

<div align="center">

[![License: MIT](https://img.shields.io/badge/License-MIT%2BOpenAI%2FAnthropic%20Rider-blue.svg)](./LICENSE)

</div>

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.

<div align="center">
<h3>Quick Install</h3>

```bash
curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/agent_settings_backup_script/main/install.sh" | bash
```

</div>

---

## Features

- **Git-versioned backups**: Every backup is a git commit with full history
- **Multiple agent support**: Cursor, Codex, Cursor, Cursor, 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 cursor v1.0`
- **Restore from tags**: Use `asb restore cursor v1.0` instead of commit hashes
- **Statistics**: View backup stats with `asb stats` and `asb stats <agent>`
- **Auto-discovery**: F