Files
claude-code/automation
OpenCode Test 125bb4904b Add search command, history browser, install script, and systemd timers
- /search command to search across memory, history, and configuration
- history-browser.py for browsing and analyzing session history
- install.sh for first-time setup with directory creation and validation
- daily-maintenance.sh for scheduled backup, cleanup, and validation
- systemd timer units for automated daily maintenance at 6 AM
- Updated shell completions with 11 aliases
- Test suite now covers 19 tests
- Bump version to 1.1.0

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-01 18:41:07 -08:00
..

Claude Automation

Scheduled automation for Claude agent workflows using systemd user timers.

Active Timers

Timer Schedule Purpose
k8s-agent-health-check.timer Every 6 hours Comprehensive cluster health check
k8s-agent-daily-summary.timer Daily at 8am Lightweight cluster status digest
claude-log-rotation.timer Weekly (Sunday midnight) Clean up old log files
restic-backup.timer Hourly Backup automation
omarchy-battery-monitor.timer Every 30 seconds Battery status monitoring

Commands

# List all timers with next run time
systemctl --user list-timers

# Check timer status
systemctl --user status k8s-agent-health-check.timer

# Manually trigger a workflow
systemctl --user start k8s-agent-health-check

# View logs
journalctl --user -u k8s-agent-health-check

# View recent logs with follow
journalctl --user -u k8s-agent-health-check -f

# Check for failed services
systemctl --user --failed

Timer Locations

All timers and services are in: ~/.config/systemd/user/

Workflows

Workflows are in: ~/.claude/workflows/

  • health/cluster-health-check.yaml - Full health check (6-hourly)
  • health/cluster-daily-summary.yaml - Quick status digest (daily)

Scheduler

The scheduler.sh script wraps Claude CLI invocations:

./scheduler.sh <workflow-name>
./scheduler.sh cluster-health-check
./scheduler.sh cluster-daily-summary

Logs

  • 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

# 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

# Reload after editing timer/service files
systemctl --user daemon-reload

# Enable a new timer
systemctl --user enable --now <timer-name>.timer

# Disable a timer
systemctl --user disable --now <timer-name>.timer