GitSync Lite for macOS

Product Introduction

1. Definition: GitSync Lite is a native macOS menu bar utility (category: Developer Tools) that monitors local/remote Git repositories and syncs git-ignored files to cloud storage.
2. Core Value Proposition: It solves fragmented Git management by providing real-time repo status tracking (branches, uncommitted changes, commit history) while securely backing up critical untracked files like .env, databases, and IDE configs to iCloud/Dropbox/OneDrive/Google Drive.

Main Features

1. Git Repository Monitoring:
   • Scans user-defined directories every 5+ minutes (configurable) via background processes.
   • Displays dirty/clean status, branch names, ahead/behind counts, last commit timestamps, and .git folder size.
   • Supports search/filtering (Cmd+K) by status, provider, or name.
2. Cloud Sync for Untracked Files:
   • Backs up git-ignored files (e.g., .env, SQLite DBs, .vscode/settings.json) to 6+ providers (iCloud, Dropbox via OAuth, OneDrive, etc.).
   • Auto-syncs changed files during scans; auto-restores when cloning repos on new machines.
   • Hierarchical file browser with custom ignore patterns to exclude noise files. Visual indicators show sync status (green = synced, orange = pending).
3. Remote Repository Integration:
   • Connects GitHub/GitLab/Bitbucket via OAuth. Lists remote/local repos in unified view.
   • One-click cloning with SSH/HTTPS protocol choice; pre-fills paths from scan directories.
4. Shallow Clone & SSH Management:
   • Converts repos to shallow clones (configurable depth) to save disk space; reverts on demand.
   • Imports SSH keys per host; stores tokens in macOS Keychain. Auto-detects auth issues.

Problems Solved

1. Pain Point: Developers lose untracked files (e.g., .env) during machine switches or repo clones.
2. Target Audience:
   • macOS-based software engineers (full-stack, DevOps) managing 10+ repositories.
   • Teams requiring consistent IDE/database configs across environments.
   • Security-conscious users avoiding Electron apps.
3. Use Cases:
   • Auto-restoring API keys/env files when onboarding new team members.
   • Monitoring 50+ repos for unpushed commits via menu bar icons.
   • Reducing .git bloat in legacy projects via shallow cloning.

Unique Advantages

1. Differentiation:
   • Outperforms CLI tools (e.g., cron jobs) with auto-restore and GUI file picker.
   • Unlike GitKraken/Sourcetree, runs 100% locally (no code/credential offloading).
2. Key Innovation:
   • Hierarchical ignore patterns for cloud sync – exclude *.log but include config/*.env.
   • Native Swift/Cocoa implementation (non-Electron) for macOS sandbox security and memory efficiency.

Frequently Asked Questions (FAQ)

1. How does GitSync Lite backup files without collecting data?
   Files sync directly from your Mac to your chosen cloud (iCloud/Dropbox/etc.) via end-to-end encryption; no servers process your data.
2. Can GitSync Lite manage SSH keys for private repositories?
   Yes, it imports SSH keys per host and stores HTTPS tokens in macOS Keychain, enabling secure access to private GitHub/GitLab/Bitbucket repos.
3. Does it support automatic env file restoration for team workflows?
   When cloning a repo on a new device, it auto-restores synced files (e.g., .env) from your linked cloud storage, ensuring consistent environments.
4. How does shallow cloning reduce storage usage?
   It truncates commit history to a configurable depth (e.g., last 10 commits), slashing .git folder size by 70–90% for older repositories.
5. Is GitSync Lite compatible with macOS sandbox security?
   Yes, it operates within Apple’s App Sandbox, using macOS jetsam for memory management and storing SSH known_hosts in isolated containers.