claude-code-sync: Instructions file for Claude Code

CLAUDE.md

Project-specific guidance for Claude Code when working on the claude-code-sync repository.

---

Project Overview

claude-code-sync is a CLI utility for backing up, restoring, and synchronizing Claude Code configurations across multiple Ubuntu machines. The tool provides encrypted backups, multiple sync strategies (git, manual, SSH direct), and intelligent conflict resolution.

Key Technologies

• Language: Bash (v4.0+)
• Platform: Ubuntu (all flavors)
• Encryption: GPG (AES-256-GCM)
• Sync Backends: Git, SSH/rsync, local filesystem
• Dependencies: gpg, tar, gzip, sha256sum, jq, rsync, git

---

Project Structure

claude-code-sync/
├── bin/
│   └── claude-code-sync              # Main CLI executable
├── lib/
│   ├── utils.sh                # Logging, utilities, helpers
│   ├── encryption.sh           # Encryption/decryption engine
│   ├── backup.sh               # Backup operations
│   ├── restore.sh              # Restore operations
│   ├── conflict.sh             # Conflict detection/resolution
│   ├── snapshot.sh             # Snapshot management
│   ├── sync.sh                 # Synchronization logic
│   └── storage.sh              # Storage backend abstraction
├── config/
│   └── default.conf            # Default configuration template
├── docs/
│   └── [user documentation]
├── tests/
│   └── [test suite]
└── claudedocs/
    ├── PROJECT_SPECIFICATION.md       # Complete requirements
    ├── ARCHITECTURE.md                # System design
    ├── IMPLEMENTATION_ROADMAP.md      # Implementation guide
    └── QUICK_START.md                # Getting started

---

Development Guidelines

Code Style

Bash Best Practices:

• Use set -euo pipefail at the start of all scripts
• Always quote variables: "$variable"
• Use readonly for constants
• Prefer functions over inline code
• Use descriptive function and variable names

Naming Conventions:

• Functions: snake_case (e.g., backup_full, encrypt_file)
• Variables: snake_case (e.g., backup_dir, encrypted_file)
• Constants: UPPER_SNAKE_CASE (e.g., CIPHER_ALGO, SYNC_DIR)
• Private functions: prefix with _ (e.g., _internal_helper)