# 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

```bash
# 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:

```bash
./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

```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
# 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
```