git-sync

Synchronize all git repositories: the top-level my-life repo and the spaces/ projects.

Usage

/git-sync              # Check status of all repos and branches
/git-sync --pull       # Pull updates for all branches
/git-sync --push       # Push local commits for all branches
/git-sync --clone      # Clone missing repos

Implementation

This skill uses a Python script for reliable validation:

python .claude/skills/git-sync/scripts/sync.py --check   # Status report
python .claude/skills/git-sync/scripts/sync.py --pull    # Pull behind branches
python .claude/skills/git-sync/scripts/sync.py --push    # Push ahead branches
python .claude/skills/git-sync/scripts/sync.py --clone   # Clone missing repos
python .claude/skills/git-sync/scripts/sync.py --json    # JSON output
python .claude/skills/git-sync/scripts/sync.py --suggest-additions  # YAML for untracked repos

Run the script from the my-life repo root directory.

What It Validates

Top-Level Repo (my-life)

• Branch status (ahead/behind/dirty/diverged)
• Uncommitted changes
• Sync status with remote

Index → Filesystem

• Each project with code: path exists in spaces/
• Git remote matches remote: in index
• Branch status (ahead/behind/dirty/diverged)

Filesystem → Index

• Finds repos in spaces/ not listed in CLAUDE.md
• Suggests YAML to add them with --suggest-additions

Report Format

============================================================
GIT SYNC REPORT
============================================================

## Top-Level Repo (my-life)

  my-life (1 branch)
    ✓ main - Up to date

## Issues

  missing-repo
    Status: missing
    Directory does not exist
    Remote: https://github.com/user/repo.git

## Repositories

  coordinatr (2 branches)
    ✓ main - Up to date
    ↑ feature/001 - 3 commits to push

  yourbench (1 branch)
    ! main - 2 uncommitted files

## Not in Index

  ? django-tutorial
    Path: spaces/django-tutorial
    Remote: https://github.com/user/django-tutorial.git

------------------------------------------------------------
SUMMARY
------------------------------------------------------------
  Top-level repo:   1 (main: up to date)
  Indexed repos:    15 (14 ok, 1 missing)
  Remote-only:      6
  Not in index:     2

  Branches ahead:   1
  Branches behind:  0
  Branches dirty:   1
  Branches diverged:0
  Local-only:       0

Status Symbols

| Symbol | Meaning | |--------|---------| | ✓ | Up to date | | ↓ | Behind remote (can pull) | | ↑ | Ahead of remote (can push) | | ↕ | Diverged (manual merge needed) | | + | Local only (no remote tracking) | | ? | Not in index | | ! | Dirty (uncommitted changes) | | ✗ | Error (check manually) |

Safety

• Never force push - if diverged, report and let user handle
• Never auto-commit - dirty repos are reported, not modified
• Fetch before status - ensure latest remote info
• Fast-forward only - pulls fail safely if not fast-forward
• Skip dirty branches - don't pull if uncommitted changes

Adding Repos to Index

Use --suggest-additions to get YAML:

python .claude/skills/git-sync/scripts/sync.py --suggest-additions

Output:

# Add to CLAUDE.md Projects Index:

  - name: django-tutorial
    code: spaces/django-tutorial/
    remote: https://github.com/user/django-tutorial.git
    branch: main
    status: active  # or: on-hold, archived, experiment

Error Handling

| Error | Resolution | |-------|------------| | Clone fails | Check network, SSH keys, permissions | | Remote mismatch | Update CLAUDE.md or fix remote | | Diverged branches | Manual merge/rebase required | | Missing remote | Repo may be local-only, skip sync |