launchd Auto-Sync Manager

Manage automatic dotfiles synchronization using launchd agents on macOS.

Overview

This skill helps you manage an auto-sync launchd agent that automatically synchronizes dotfiles changes to GitHub every hour.

**Key Components:**

Common Operations

Check Agent Status

```bash

launchctl list | grep dotfiles

```

View Configuration Files

```bash

Check plist configuration

cat ~/Library/LaunchAgents/com.user.dotfiles-sync.plist

Check auto-sync script

cat /Users/snkrheadz/ghq/github.com/snkrheadz/laptop/scripts/auto-sync.sh

```

Monitor Logs

```bash

View last 50 log entries

cat ~/Library/Logs/dotfiles-sync.log | tail -50

View most recent entries

tail -20 ~/Library/Logs/dotfiles-sync.log

```

Agent Management

```bash

Stop agent

launchctl unload ~/Library/LaunchAgents/com.user.dotfiles-sync.plist

Start agent

launchctl load ~/Library/LaunchAgents/com.user.dotfiles-sync.plist

Restart agent

launchctl unload ~/Library/LaunchAgents/com.user.dotfiles-sync.plist && \

launchctl load ~/Library/LaunchAgents/com.user.dotfiles-sync.plist

```

Manual Operations

```bash

Run sync manually

/Users/snkrheadz/ghq/github.com/snkrheadz/laptop/scripts/auto-sync.sh

Validate plist syntax

plutil -lint ~/Library/LaunchAgents/com.user.dotfiles-sync.plist

```

Auto-Sync Process Flow

The auto-sync script performs these steps:

1. Navigate to dotfiles directory

2. Run `brew bundle dump --force` to update Brewfile

3. Stage all changes with `git add -A`

4. Commit changes if any exist

5. Push to remote repository

Troubleshooting Workflow

When issues occur:

1. Check agent status with `launchctl list | grep dotfiles`

2. Review logs to investigate last execution results

3. Test script manually to verify functionality

4. Restart agent if necessary

Usage Examples

Important Notes