WSL2 Setup

WSL2 can shut down idle instances, which kills your bot. Two settings prevent this.

1. Enable systemd

Edit /etc/wsl.conf (create it if it doesn't exist):

[boot]
systemd=true

Restart WSL: in PowerShell, run wsl --shutdown then reopen your WSL terminal.

2. Disable idle timeout

Create or edit ~/.wslconfig (in your Windows home directory, e.g. C:\Users\you\.wslconfig):

[wsl2]
vmIdleTimeout=-1

Restart WSL again.

3. Install systemd units

bash scripts/install-systemd.sh

This copies all unit files, enables linger (so units survive logout), starts claude-main.service, and enables the nightly backup and dreaming timers.

4. Verify

systemctl --user status claude-main.service

Expected: active (running).

5. View logs

journalctl --user -u claude-main.service -f