gitsync

Synchronize multi-package workspaces across machines with state-driven git commits, pushes, and pulls.

23|Updated Jul 4, 2025
One-click install
npx skills add https://github.com/jimmyff/nixfiles --skill gitsync-jimmyff
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gitsync
Source: https://github.com/jimmyff/nixfiles/tree/main/dotfiles/ai/skills/gitsync
Command: npx skills add https://github.com/jimmyff/nixfiles --skill gitsync-jimmyff

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bring a resolved, state-driven method to synchronize a multi-package workspace across machines by coordinating commits, pushes, and pulls based on dirty repos, ensuring consistency when switching devices.

Core Features & Use Cases

  • Orchestrates per-repo checks, staged commits, and pushes/pulls across multiple repos managed by Glittering.
  • Ensures a clean working state when arriving at a new machine or switching tasks across machines.
  • Provides a deterministic, auditable workflow for multi-repo synchronization, including submodule handling and parent/child refs.

Quick Start

Switch machines and run gitsync to synchronize all repos and verify a clean state.

Frequently Asked Questions about gitsync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync a multi-repo workspace across different machines?

A multi-package workspace synchronizes across machines by coordinating commits, pushes, and pulls through a state-driven dirty-check workflow. This process ensures a clean working state and repository consistency when switching devices.

How does state-driven git synchronization handle dirty repositories?

State-driven git synchronization enforces a predictable orient-dirty-commit-pull-verify sequence to handle dirty repositories. It performs per-repo checks, staged commits, and submodule handling to maintain consistency across multiple managed repositories.

Can I automate git commits and pulls for multiple repositories when switching devices?

Yes, you can automate git commits and pulls for multiple repositories when switching devices. Running gitsync orchestrates per-repo checks, staged commits, and pushes or pulls to synchronize your multi-package workspace and verify a clean state.

What is the best way to ensure a clean git state across submodules in multiple repos?

The best way to ensure a clean git state across submodules in multiple repos is using a deterministic workflow that handles parent and child references. Gitsync coordinates per-repo checks and submodule handling to verify consistency across all managed repositories.

Does multi-repo git synchronization work without manual commit and push commands?

Yes, multi-repo git synchronization works without manual commit and push commands. It leverages an automated dirty-check workflow that coordinates staged commits and pushes across multiple repos managed by Glittering when you leave or arrive on a machine.