Agent Settings Backup Script banner
Dicklesworthstone Dicklesworthstone

Agent Settings Backup Script

AI community

Description

Git-versioned backup tool for AI coding agent config folders (Claude Code, Cursor, Codex, etc.) with size-based rotation and easy restoration

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

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

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: 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: F