Repository Management Tools

A comprehensive collection of PowerShell scripts and utilities for managing GitHub repositories, authentication, and synchronization across multiple devices.

📁 Directory Structure

repo-management-tools/
├── sync-scripts/      # GitHub repository synchronization automation
├── auth-setup/        # SSH and authentication configuration
├── docs/              # Documentation and frameworks
├── config/            # Configuration templates
└── README.md          # This file

---

🔄 Sync Scripts

Located in sync-scripts/

ultimate-github-sync.ps1

Primary sync solution - Universal GitHub repository synchronization

• Auto-discovers ALL your GitHub repositories
• Clones missing repositories
• Pulls latest changes from all repos
• Commits and pushes local changes
• Works on Windows, Linux, macOS

Usage:

.\ultimate-github-sync.ps1 -Mode Sync        # Full sync operation
.\ultimate-github-sync.ps1 -Mode Status      # Check status only
.\ultimate-github-sync.ps1 -Mode Clone       # Clone missing repos
.\ultimate-github-sync.ps1 -Force            # Skip confirmations

auto-sync.ps1

Auto-discovery GitHub sync with network location support

• Discovers and connects to travel servers
• Works with multiple network locations
• Supports local-only mode

Usage:

.\auto-sync.ps1 -Sync           # Sync with discovered server
.\auto-sync.ps1 -LocalOnly      # Local operations only
.\auto-sync.ps1 -Discover       # Discover available servers

auto-sync-safe.ps1

Enhanced version with safety checks and validation

auto-clone-and-sync.ps1

Automated cloning and synchronization workflow

ultimate-auto-sync.ps1

Advanced auto-sync with additional features

comprehensive-sync.ps1

Full-featured synchronization with comprehensive reporting

local-sync.ps1

Local repository synchronization without remote operations

check-repo-status.ps1

Quick status check across all repositories

• Shows uncommitted changes
• Lists unpushed commits
• Displays branch information

Usage:

.\check-repo-status.ps1

install-github-sync-task.ps1

Installs scheduled task for automatic GitHub synchronization

Usage:

.\install-github-sync-task.ps1

test-github-sync-task.ps1

Tests the installed sync task configuration

---

🔐 Authentication Setup

Located in auth-setup/

Setup-PasswordlessAuth.ps1

Configures SSH for passwordless GitHub authentication

• Generates ED25519 SSH keys
• Configures SSH for GitHub
• Tests connection

Usage:

.\Setup-PasswordlessAuth.ps1 -Install    # Set up passwordless auth
.\Setup-PasswordlessAuth.ps1 -ShowKey    # Display public key
.\Setup-PasswordlessAuth.ps1 -Test       # Test connection

Verify-PasswordlessAuth.ps1

Verifies SSH authentication is working correctly

Usage:

.\Verify-PasswordlessAuth.ps1

ssh-config-template.txt

Template SSH configuration file for reference

---

📚 Documentation

Located in docs/

GitOS-Desktop-Design.md

Design documentation for the GitOS Desktop project

GitOS-Desktop-Implementation.md

Implementation guide and technical details for GitOS Desktop

GitOS-Desktop-Summary.md

High-level summary of the GitOS Desktop system

Ethical-AI-Programming-Framework.md

Framework and guidelines for ethical AI development practices

---

⚙️ Configuration

Located in config/

Repositories.code-workspace

VS Code workspace configuration for managing all repositories

---

🚀 Quick Start

First-Time Setup

1. Set up SSH authentication:

   cd auth-setup
   .\Setup-PasswordlessAuth.ps1 -Install

2. Add your SSH key to GitHub:

   .\Setup-PasswordlessAuth.ps1 -ShowKey

   Copy the output and add to: https://github.com/settings/keys

3. Test authentication:

   .\Verify-PasswordlessAuth.ps1

4. Sync all repositories:

   cd ..\sync-scripts
   .\ultimate-github-sync.ps1 -Mode Sync -Force

Daily Usage

Check repository status:

.\check-repo-status.ps1

Sync all changes:

.\ultimate-github-sync.ps1 -Mode Sync

Install automatic sync:

.\install-github-sync-task.ps1

---

📋 Requirements

• PowerShell 5.1 or higher (PowerShell 7+ recommended)
• Git installed and configured
• GitHub account with SSH key access
• OpenSSH client (Windows 10/11 built-in)

---

🔧 Configuration

Most scripts use these default paths:

• Local Repos: C:\Users\lr598\Proton Drive\lreyesr\My files\Repositories
• GitHub User: LReyes21
• Server User: luis
• Server Repos: /home/luis/repositories

Edit the configuration section at the top of each script to customize for your environment.

---

📝 Notes

• All scripts are designed to work cross-platform (Windows/Linux/macOS)
• Scripts use #!/usr/bin/env pwsh shebang for compatibility
• Most scripts support -WhatIf and -Verbose parameters
• Logs are typically written to console with timestamps

---

🤝 Contributing

This is a personal utility collection. Feel free to adapt these scripts for your own use.

---

📄 License

Personal use - adapt as needed for your workflows.

---

Last Updated: November 2025