github-sync-agent 0.1.4

Sync all your local projects to GitHub automatically

GitHub Sync Agent

Automatically syncs every local project directory to its own GitHub repository.

For each project it will:

1. git init if not already a repo
2. Create the GitHub repo if it doesn't exist yet
3. Ensure the remote uses SSH
4. Stage + commit any uncommitted changes
5. Push to origin

Runs daily via a systemd user timer, and on-demand via CLI.

---

Installation

pip install github-sync-agent

First-time setup

github-sync init

The wizard will:

• Check git and gh are installed
• Authenticate with GitHub (gh auth login)
• Ask which folder to scan for projects
• Set up your SSH key automatically
• Verify SSH works (auto-fixes port 443 and ssh-agent if needed)
• Write a config file to ~/.config/github-sync/config.yaml

Setup will not complete until ssh -T [e-mail] succeeds.

---

Usage

# Sync all projects
github-sync sync

# Sync a single project
github-sync sync --project my-project

# Preview without making changes
github-sync sync --dry-run

# Show status of all projects
github-sync status

---

Configuration (~/.config/github-sync/config.yaml)

Generated by github-sync init. You can edit it at any time.

Key	Default	Description
github_user	(detected from gh auth)	Your GitHub username
projects_root	~/projects	Scans all subdirectories here
schedule_time	02:00	Daily run time
default_visibility	private	private or public for new repos
auto_commit_message	chore: auto-sync	Commit message for auto-commits
exclude	[]	Directory names to skip
log_file	~/.local/share/github-sync/github-sync.log	Log file path
log_level	INFO	DEBUG / INFO / WARNING / ERROR

Excluding a project

exclude:
  - SomeProjectToSkip

---

Requirements

• Python 3.10+
• git installed
• gh (GitHub CLI) installed — installation guide

---

License

MIT