# Agent Settings Backup (asb)

asb - Smart backup tool for AI coding agent configurations

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

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

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

--- ## 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 ` - **Auto-discovery**: F

Agents

agent_settings_backup_script