sync-all-repos

Sync All Repos

Discover every GitHub-backed git repo on the current machine, classify each by sync state, auto-execute the obvious cases (clean repo behind/ahead/diverged from origin), and report the ambiguous cases (uncommitted changes, non-main branches, rebase conflicts) for Claude to resolve case by case.

Use this when:

• You sit down at the Mac or VPS and want to catch up with whatever the OTHER machine pushed to GitHub since last session
• You're about to walk away and want to ensure all committed-but-not-pushed work is on GitHub
• You suspect drift between machines and want a single-shot reconciliation

This skill does NOT:

• Coordinate Mac↔VPS directly (each machine syncs with GitHub independently)
• Auto-stash, auto-commit, or auto-resolve conflicts (Claude decides per case)
• Touch non-GitHub repos (gitlab, bitbucket, self-hosted git all skipped)
• Run on a timer (explicit invocation only)

Step 1: Discover repos

Search roots:

• ~/Documents/GitHub/ (depth ≤2)
• ~/Documents/jira nbch/ (cds-dashboard, jira-nbch)
• ~/Documents/crm/
• Any additional path in $DOTFORGE_DIR/registry/projects.local.yml not covered above

For each candidate directory at depth ≤2 with a .git/ subdirectory:

REMOTE=$(git -C "$dir" config --get remote.origin.url 2>/dev/null)
case "$REMOTE" in
  *github.com*) ;;
  *) continue ;;  # non-GitHub: skip silently
esac

# Opt-out marker: project declares itself out of sync scope
if [[ -f "$dir/.dotforge-sync-ignore" ]]; then
  reason=$(head -1 "$dir/.dotforge-sync-ignore" 2>/dev/null)
  reason=${reason:-"opt-out (no reason given)"}
  echo "IGNORED|$dir|$reason"
  continue
fi

echo "$dir"

Skip silently:

• Directories without .git/
• Repos with no origin remote
• Repos with origin not pointing at GitHub

Skip with note (reported under "Ignored" in the final summary):

• Repos with a .dotforge-sync-ignore file at root. The first line of that file is shown as the reason. Use this for archived projects, vendored repos, or any GitHub-backed repo you deliberately don't want auto-synced. The marker is in the project's own working tree — version-controlled by that project, not by dotforge.