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

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