Add session, maintenance, and backup commands

New commands:
- /summarize: Save session decisions/preferences to memory
- /maintain: Configuration maintenance (validate, backup, restore, etc.)

New automation scripts:
- backup.sh: Create timestamped config backup (excludes secrets)
- restore.sh: Restore config from backup (with validation)

Updates:
- component-registry.json: Added new commands
- commands/README.md: Updated with new entries
- automation/README.md: Documented utility scripts

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
OpenCode Test
2026-01-01 12:11:52 -08:00
parent cbed85edf5
commit f682d781a0
7 changed files with 432 additions and 0 deletions

View File

@@ -60,6 +60,34 @@ The `scheduler.sh` script wraps Claude CLI invocations:
- Workflow logs: `~/.claude/logs/workflows/`
- Journal logs: `journalctl --user -u <service-name>`
## Utility Scripts
| Script | Purpose |
|--------|---------|
| `validate-setup.sh` | Validate configuration |
| `quick-status.sh` | Dashboard status overview |
| `backup.sh` | Create configuration backup |
| `restore.sh` | Restore from backup |
| `generate-registry.py` | Regenerate component registry |
| `validate-registry.py` | Validate component registry |
### Usage
```bash
# Validate setup
./validate-setup.sh
# Quick status
./quick-status.sh
# Backup
./backup.sh
# Restore (lists backups, or restores specific file)
./restore.sh
./restore.sh ~/.claude/backups/claude-config-TIMESTAMP.tar.gz
```
## Maintenance
```bash

92
automation/backup.sh Executable file
View File

@@ -0,0 +1,92 @@
#!/bin/bash
# Backup Claude Code configuration
# Creates a timestamped archive of important files
set -euo pipefail
CLAUDE_DIR="${HOME}/.claude"
BACKUP_DIR="${CLAUDE_DIR}/backups"
TIMESTAMP=$(date +%Y%m%d_%H%M%S)
BACKUP_NAME="claude-config-${TIMESTAMP}"
BACKUP_PATH="${BACKUP_DIR}/${BACKUP_NAME}.tar.gz"
# Colors
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
NC='\033[0m'
echo "📦 Claude Code Configuration Backup"
echo ""
# Create backup directory
mkdir -p "${BACKUP_DIR}"
# Files to backup (relative to CLAUDE_DIR)
BACKUP_ITEMS=(
"CLAUDE.md"
"README.md"
"settings.json"
".gitignore"
".claude-plugin"
"agents"
"commands"
"hooks"
"skills"
"workflows"
"state"
"automation"
)
# Create temporary directory
TEMP_DIR=$(mktemp -d)
TEMP_BACKUP="${TEMP_DIR}/${BACKUP_NAME}"
mkdir -p "${TEMP_BACKUP}"
echo "Copying files..."
for item in "${BACKUP_ITEMS[@]}"; do
if [[ -e "${CLAUDE_DIR}/${item}" ]]; then
cp -r "${CLAUDE_DIR}/${item}" "${TEMP_BACKUP}/"
echo -e " ${GREEN}${NC} ${item}"
else
echo -e " ${YELLOW}!${NC} ${item} (not found)"
fi
done
# Exclude sensitive files
echo ""
echo "Excluding sensitive files..."
find "${TEMP_BACKUP}" -name "*.key" -delete 2>/dev/null || true
find "${TEMP_BACKUP}" -name "*.pem" -delete 2>/dev/null || true
find "${TEMP_BACKUP}" -name "credentials.json" -delete 2>/dev/null || true
find "${TEMP_BACKUP}" -name "token.json" -delete 2>/dev/null || true
find "${TEMP_BACKUP}" -name "settings.local.json" -delete 2>/dev/null || true
# Create archive
echo ""
echo "Creating archive..."
tar -czf "${BACKUP_PATH}" -C "${TEMP_DIR}" "${BACKUP_NAME}"
# Cleanup
rm -rf "${TEMP_DIR}"
# Get size
SIZE=$(du -h "${BACKUP_PATH}" | cut -f1)
echo ""
echo -e "${GREEN}${NC} Backup complete!"
echo ""
echo "Location: ${BACKUP_PATH}"
echo "Size: ${SIZE}"
echo ""
# List recent backups
echo "Recent backups:"
ls -lht "${BACKUP_DIR}"/*.tar.gz 2>/dev/null | head -5 || echo " (none)"
# Cleanup old backups (keep last 10)
BACKUP_COUNT=$(ls -1 "${BACKUP_DIR}"/*.tar.gz 2>/dev/null | wc -l)
if [[ ${BACKUP_COUNT} -gt 10 ]]; then
echo ""
echo "Cleaning up old backups (keeping last 10)..."
ls -1t "${BACKUP_DIR}"/*.tar.gz | tail -n +11 | xargs rm -f
fi

115
automation/restore.sh Executable file
View File

@@ -0,0 +1,115 @@
#!/bin/bash
# Restore Claude Code configuration from backup
# Usage: restore.sh [backup-file]
set -euo pipefail
CLAUDE_DIR="${HOME}/.claude"
BACKUP_DIR="${CLAUDE_DIR}/backups"
# Colors
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
NC='\033[0m'
echo "📦 Claude Code Configuration Restore"
echo ""
# Get backup file
BACKUP_FILE="${1:-}"
if [[ -z "${BACKUP_FILE}" ]]; then
# List available backups
echo "Available backups:"
echo ""
if ls -1t "${BACKUP_DIR}"/*.tar.gz 2>/dev/null | head -10; then
echo ""
echo "Usage: $0 <backup-file>"
echo "Example: $0 ${BACKUP_DIR}/claude-config-20260101_120000.tar.gz"
else
echo " No backups found in ${BACKUP_DIR}"
fi
exit 1
fi
# Verify backup exists
if [[ ! -f "${BACKUP_FILE}" ]]; then
echo -e "${RED}Error: Backup file not found: ${BACKUP_FILE}${NC}"
exit 1
fi
# Confirm restore
echo -e "${YELLOW}Warning: This will overwrite existing configuration!${NC}"
echo ""
echo "Backup: ${BACKUP_FILE}"
echo "Target: ${CLAUDE_DIR}"
echo ""
read -p "Continue? [y/N] " -n 1 -r
echo ""
if [[ ! $REPLY =~ ^[Yy]$ ]]; then
echo "Cancelled."
exit 0
fi
# Create temporary directory
TEMP_DIR=$(mktemp -d)
echo ""
echo "Extracting backup..."
tar -xzf "${BACKUP_FILE}" -C "${TEMP_DIR}"
# Find the extracted directory
EXTRACTED_DIR=$(find "${TEMP_DIR}" -maxdepth 1 -type d -name "claude-config-*" | head -1)
if [[ -z "${EXTRACTED_DIR}" ]]; then
echo -e "${RED}Error: Invalid backup format${NC}"
rm -rf "${TEMP_DIR}"
exit 1
fi
# Items to restore
RESTORE_ITEMS=(
"CLAUDE.md"
"README.md"
"settings.json"
".gitignore"
".claude-plugin"
"agents"
"commands"
"hooks"
"skills"
"workflows"
"state"
"automation"
)
echo ""
echo "Restoring files..."
for item in "${RESTORE_ITEMS[@]}"; do
if [[ -e "${EXTRACTED_DIR}/${item}" ]]; then
# Backup existing before overwrite
if [[ -e "${CLAUDE_DIR}/${item}" ]]; then
rm -rf "${CLAUDE_DIR}/${item}"
fi
cp -r "${EXTRACTED_DIR}/${item}" "${CLAUDE_DIR}/"
echo -e " ${GREEN}${NC} ${item}"
fi
done
# Cleanup
rm -rf "${TEMP_DIR}"
echo ""
echo -e "${GREEN}${NC} Restore complete!"
echo ""
echo "Note: You may need to restart Claude Code for changes to take effect."
echo ""
# Run validation
if [[ -x "${CLAUDE_DIR}/automation/validate-setup.sh" ]]; then
echo "Running validation..."
echo ""
"${CLAUDE_DIR}/automation/validate-setup.sh" || true
fi