github-sync-agent 0.1.0__tar.gz

github_sync_agent-0.1.0/PKG-INFO

@@ -0,0 +1,132 @@
+Metadata-Version: 2.4
+Name: github-sync-agent
+Version: 0.1.0
+Summary: Sync all your local projects to GitHub automatically
+Author: yuvalavni
+License: MIT
+Project-URL: Homepage, https://github.com/yuvalavni/Agents
+Project-URL: Repository, https://github.com/yuvalavni/Agents
+Keywords: github,git,sync,backup,automation,cli
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Environment :: Console
+Classifier: Topic :: Software Development :: Version Control :: Git
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: click>=8.0
+
+# GitHub Sync Agent
+
+Automatically syncs every project under `/home/yuval/projects` to GitHub (`github.com/yuvalavni`).
+
+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 at **02:00** via a systemd user timer, and on-demand via CLI.
+
+---
+
+## Directory layout
+
+```
+agents/github-sync/
+├── github_sync_agent.py   # Main script
+├── config.yaml            # GitHub user, projects root, schedule, exclusions
+├── requirements.txt
+├── install.sh             # One-time setup
+├── systemd/
+│   ├── github-sync.service
+│   └── github-sync.timer
+└── logs/
+    └── github-sync.log
+```
+
+---
+
+## Quick start
+
+```bash
+cd /home/yuval/projects/Agents/agents/github-sync
+
+# 1. Install (once)
+bash install.sh
+
+# 2. Dry run
+.venv/bin/python github_sync_agent.py --dry-run
+
+# 3. Sync for real
+.venv/bin/python github_sync_agent.py
+```
+
+---
+
+## Configuration (`config.yaml`)
+
+| Key | Default | Description |
+|-----|---------|-------------|
+| `github_user` | `yuvalavni` | GitHub username |
+| `projects_root` | `/home/yuval/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` | `logs/github-sync.log` | Log file path |
+| `log_level` | `INFO` | `DEBUG` / `INFO` / `WARNING` / `ERROR` |
+
+### Excluding a project
+
+```yaml
+exclude:
+  - SomePrivateProject
+  - TempExperiment
+```
+
+---
+
+## CLI reference
+
+```bash
+# Sync all projects
+.venv/bin/python github_sync_agent.py
+
+# Sync a single project
+.venv/bin/python github_sync_agent.py --project Agents
+
+# Preview without making any changes
+.venv/bin/python github_sync_agent.py --dry-run
+
+# Show status of all projects (git, remote, changes, GitHub)
+.venv/bin/python github_sync_agent.py --status
+```
+
+---
+
+## Systemd
+
+```bash
+# Trigger immediately
+systemctl --user start github-sync.service
+
+# Check next scheduled run
+systemctl --user list-timers github-sync.timer
+
+# View live logs
+journalctl --user -u github-sync.service -f
+
+# Disable daily timer
+systemctl --user disable --now github-sync.timer
+```
+
+---
+
+## Prerequisites
+
+- `git` installed
+- `gh` installed and authenticated (`gh auth status`)
+- SSH key added to GitHub (`gh ssh-key list`)

github_sync_agent-0.1.0/README.md

@@ -0,0 +1,113 @@
+# GitHub Sync Agent
+
+Automatically syncs every project under `/home/yuval/projects` to GitHub (`github.com/yuvalavni`).
+
+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 at **02:00** via a systemd user timer, and on-demand via CLI.
+
+---
+
+## Directory layout
+
+```
+agents/github-sync/
+├── github_sync_agent.py   # Main script
+├── config.yaml            # GitHub user, projects root, schedule, exclusions
+├── requirements.txt
+├── install.sh             # One-time setup
+├── systemd/
+│   ├── github-sync.service
+│   └── github-sync.timer
+└── logs/
+    └── github-sync.log
+```
+
+---
+
+## Quick start
+
+```bash
+cd /home/yuval/projects/Agents/agents/github-sync
+
+# 1. Install (once)
+bash install.sh
+
+# 2. Dry run
+.venv/bin/python github_sync_agent.py --dry-run
+
+# 3. Sync for real
+.venv/bin/python github_sync_agent.py
+```
+
+---
+
+## Configuration (`config.yaml`)
+
+| Key | Default | Description |
+|-----|---------|-------------|
+| `github_user` | `yuvalavni` | GitHub username |
+| `projects_root` | `/home/yuval/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` | `logs/github-sync.log` | Log file path |
+| `log_level` | `INFO` | `DEBUG` / `INFO` / `WARNING` / `ERROR` |
+
+### Excluding a project
+
+```yaml
+exclude:
+  - SomePrivateProject
+  - TempExperiment
+```
+
+---
+
+## CLI reference
+
+```bash
+# Sync all projects
+.venv/bin/python github_sync_agent.py
+
+# Sync a single project
+.venv/bin/python github_sync_agent.py --project Agents
+
+# Preview without making any changes
+.venv/bin/python github_sync_agent.py --dry-run
+
+# Show status of all projects (git, remote, changes, GitHub)
+.venv/bin/python github_sync_agent.py --status
+```
+
+---
+
+## Systemd
+
+```bash
+# Trigger immediately
+systemctl --user start github-sync.service
+
+# Check next scheduled run
+systemctl --user list-timers github-sync.timer
+
+# View live logs
+journalctl --user -u github-sync.service -f
+
+# Disable daily timer
+systemctl --user disable --now github-sync.timer
+```
+
+---
+
+## Prerequisites
+
+- `git` installed
+- `gh` installed and authenticated (`gh auth status`)
+- SSH key added to GitHub (`gh ssh-key list`)

github_sync_agent-0.1.0/github_sync/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

github_sync_agent-0.1.0/github_sync/agent.py

@@ -0,0 +1,192 @@
+"""Core sync logic — no CLI concerns here."""
+
+import logging
+import subprocess
+from pathlib import Path
+
+
+# ---------------------------------------------------------------------------
+# Shell helpers
+# ---------------------------------------------------------------------------
+
+def _run(cmd: list[str], cwd: Path | None = None) -> tuple[bool, str]:
+    result = subprocess.run(cmd, cwd=cwd, capture_output=True, text=True)
+    return result.returncode == 0, (result.stdout + result.stderr).strip()
+
+
+# ---------------------------------------------------------------------------
+# Git helpers
+# ---------------------------------------------------------------------------
+
+def is_git_repo(path: Path) -> bool:
+    ok, _ = _run(["git", "rev-parse", "--git-dir"], cwd=path)
+    return ok
+
+
+def git_init(path: Path, dry_run: bool) -> None:
+    if dry_run:
+        logging.info(f"[DRY-RUN] Would git init: {path}")
+        return
+    _run(["git", "init"], cwd=path)
+
+
+def has_remote(path: Path) -> bool:
+    ok, _ = _run(["git", "remote", "get-url", "origin"], cwd=path)
+    return ok
+
+
+def add_remote(path: Path, github_user: str, project: str, dry_run: bool) -> None:
+    url = f"git@github.com:{github_user}/{project}.git"
+    if dry_run:
+        logging.info(f"[DRY-RUN] Would add remote: {url}")
+        return
+    _run(["git", "remote", "add", "origin", url], cwd=path)
+
+
+def ensure_ssh_remote(path: Path, github_user: str, project: str, dry_run: bool) -> None:
+    _, url = _run(["git", "remote", "get-url", "origin"], cwd=path)
+    if url.startswith("https://"):
+        ssh_url = f"git@github.com:{github_user}/{project}.git"
+        if dry_run:
+            logging.info(f"[DRY-RUN] Would switch remote to SSH: {ssh_url}")
+            return
+        _run(["git", "remote", "set-url", "origin", ssh_url], cwd=path)
+        logging.info(f"Switched remote to SSH")
+
+
+def has_commits(path: Path) -> bool:
+    ok, _ = _run(["git", "rev-parse", "HEAD"], cwd=path)
+    return ok
+
+
+def has_uncommitted_changes(path: Path) -> bool:
+    ok, output = _run(["git", "status", "--porcelain"], cwd=path)
+    return ok and bool(output.strip())
+
+
+def stage_and_commit(path: Path, message: str, dry_run: bool) -> bool:
+    if dry_run:
+        logging.info(f"[DRY-RUN] Would commit: '{message}'")
+        return True
+    _run(["git", "add", "-A"], cwd=path)
+    ok, _ = _run(["git", "diff", "--cached", "--quiet"], cwd=path)
+    if ok:
+        return False  # nothing staged
+    _run(["git", "commit", "-m", message], cwd=path)
+    return True
+
+
+def push(path: Path, dry_run: bool) -> bool:
+    if dry_run:
+        logging.info("[DRY-RUN] Would push to origin")
+        return True
+    ok, out = _run(["git", "push", "-u", "origin", "HEAD"], cwd=path)
+    if not ok:
+        logging.error(f"Push failed: {out}")
+    return ok
+
+
+def get_remote_url(path: Path) -> str:
+    _, url = _run(["git", "remote", "get-url", "origin"], cwd=path)
+    return url
+
+
+# ---------------------------------------------------------------------------
+# GitHub helpers
+# ---------------------------------------------------------------------------
+
+def github_repo_exists(github_user: str, project: str) -> bool:
+    ok, _ = _run(["gh", "repo", "view", f"{github_user}/{project}"])
+    return ok
+
+
+def create_github_repo(github_user: str, project: str, visibility: str, dry_run: bool) -> bool:
+    flag = "--private" if visibility == "private" else "--public"
+    if dry_run:
+        logging.info(f"[DRY-RUN] Would create GitHub repo: {github_user}/{project} ({visibility})")
+        return True
+    ok, out = _run(["gh", "repo", "create", f"{github_user}/{project}", flag])
+    if ok:
+        logging.info(f"Created GitHub repo: https://github.com/{github_user}/{project}")
+    else:
+        logging.error(f"Failed to create repo: {out}")
+    return ok
+
+
+# ---------------------------------------------------------------------------
+# Per-project sync
+# ---------------------------------------------------------------------------
+
+def sync_project(path: Path, cfg: dict, dry_run: bool) -> bool:
+    project = path.name
+    github_user = cfg["github_user"]
+
+    logging.info(f"── {project}")
+
+    if not is_git_repo(path):
+        git_init(path, dry_run)
+
+    if not github_repo_exists(github_user, project):
+        if not create_github_repo(github_user, project, cfg["default_visibility"], dry_run):
+            return False
+
+    if not has_remote(path):
+        add_remote(path, github_user, project, dry_run)
+    else:
+        ensure_ssh_remote(path, github_user, project, dry_run)
+
+    if not has_commits(path) or has_uncommitted_changes(path):
+        stage_and_commit(path, cfg["auto_commit_message"], dry_run)
+
+    if not has_commits(path):
+        logging.warning("  No commits yet — nothing to push.")
+        return True
+
+    ok = push(path, dry_run)
+    if ok:
+        logging.info("  ✓ Synced")
+    return ok
+
+
+# ---------------------------------------------------------------------------
+# Discover projects
+# ---------------------------------------------------------------------------
+
+def discover_projects(cfg: dict, project_name: str | None = None) -> list[Path]:
+    root = Path(cfg["projects_root"])
+    exclude = set(cfg.get("exclude", []))
+
+    if project_name:
+        path = root / project_name
+        if not path.is_dir():
+            raise ValueError(f"Project '{project_name}' not found in {root}")
+        return [path]
+
+    return sorted(
+        p for p in root.iterdir()
+        if p.is_dir() and p.name not in exclude and not p.name.startswith(".")
+    )
+
+
+# ---------------------------------------------------------------------------
+# Status table
+# ---------------------------------------------------------------------------
+
+def get_status(cfg: dict) -> list[dict]:
+    root = Path(cfg["projects_root"])
+    exclude = set(cfg.get("exclude", []))
+    github_user = cfg["github_user"]
+    rows = []
+
+    for path in sorted(root.iterdir()):
+        if not path.is_dir() or path.name in exclude or path.name.startswith("."):
+            continue
+        rows.append({
+            "project": path.name,
+            "git": is_git_repo(path),
+            "remote": is_git_repo(path) and has_remote(path),
+            "changes": has_uncommitted_changes(path) if is_git_repo(path) else False,
+            "on_github": github_repo_exists(github_user, path.name),
+        })
+
+    return rows

github_sync_agent-0.1.0/github_sync/cli.py

@@ -0,0 +1,234 @@
+import logging
+import sys
+from pathlib import Path
+
+import click
+
+from . import __version__
+from . import agent, config, setup
+
+LOG_FORMAT = "%(asctime)s  %(levelname)-8s  %(message)s"
+
+
+def _setup_logging(cfg: dict) -> None:
+    log_file = cfg["log_file"]
+    Path(log_file).parent.mkdir(parents=True, exist_ok=True)
+    logging.basicConfig(
+        level=getattr(logging, cfg["log_level"].upper(), logging.INFO),
+        format=LOG_FORMAT,
+        handlers=[
+            logging.StreamHandler(sys.stdout),
+            logging.FileHandler(log_file, encoding="utf-8"),
+        ],
+    )
+
+
+# ---------------------------------------------------------------------------
+# Root command group
+# ---------------------------------------------------------------------------
+
+@click.group()
+@click.version_option(__version__, prog_name="github-sync")
+@click.option("--config", "config_path", type=click.Path(path_type=Path),
+              default=None, help="Path to config.yaml")
+@click.pass_context
+def cli(ctx: click.Context, config_path: Path | None) -> None:
+    """GitHub Sync Agent — sync local projects to GitHub."""
+    ctx.ensure_object(dict)
+    try:
+        ctx.obj["cfg"] = config.load(config_path)
+    except (FileNotFoundError, ValueError) as exc:
+        click.echo(f"Error: {exc}", err=True)
+        sys.exit(1)
+
+
+# ---------------------------------------------------------------------------
+# sync
+# ---------------------------------------------------------------------------
+
+@cli.command()
+@click.option("--project", "-p", default=None,
+              help="Sync a single project by name (default: all)")
+@click.option("--dry-run", is_flag=True,
+              help="Show what would happen without making changes")
+@click.pass_context
+def sync(ctx: click.Context, project: str | None, dry_run: bool) -> None:
+    """Sync projects to GitHub."""
+    cfg = ctx.obj["cfg"]
+    _setup_logging(cfg)
+
+    if dry_run:
+        logging.info("=== DRY-RUN — no changes will be made ===")
+
+    try:
+        projects = agent.discover_projects(cfg, project)
+    except ValueError as exc:
+        click.echo(f"Error: {exc}", err=True)
+        sys.exit(1)
+
+    logging.info(f"Syncing {len(projects)} project(s) → github.com/{cfg['github_user']}")
+
+    results = []
+    for path in projects:
+        ok = agent.sync_project(path, cfg, dry_run)
+        results.append((path.name, ok))
+
+    successes = sum(1 for _, ok in results if ok)
+    failures = len(results) - successes
+    logging.info(f"Done: {successes} succeeded, {failures} failed.")
+
+    if failures:
+        for name, ok in results:
+            if not ok:
+                logging.error(f"  FAILED: {name}")
+        sys.exit(1)
+
+
+# ---------------------------------------------------------------------------
+# status
+# ---------------------------------------------------------------------------
+
+@cli.command()
+@click.pass_context
+def status(ctx: click.Context) -> None:
+    """Show sync status for all projects."""
+    cfg = ctx.obj["cfg"]
+    rows = agent.get_status(cfg)
+
+    click.echo(f"\nProjects root : {cfg['projects_root']}")
+    click.echo(f"GitHub user   : {cfg['github_user']}\n")
+
+    header = f"{'Project':<25} {'Git':<6} {'Remote':<8} {'Changes':<10} {'On GitHub'}"
+    click.echo(header)
+    click.echo("─" * len(header))
+
+    for row in rows:
+        click.echo(
+            f"{row['project']:<25} "
+            f"{'✓' if row['git'] else '✗':<6} "
+            f"{'✓' if row['remote'] else '✗':<8} "
+            f"{'dirty' if row['changes'] else 'clean':<10} "
+            f"{'✓' if row['on_github'] else '✗'}"
+        )
+    click.echo()
+
+
+# ---------------------------------------------------------------------------
+# init
+# ---------------------------------------------------------------------------
+
+@cli.command()
+def init() -> None:
+    """Interactive setup wizard — run this first on a new machine."""
+    click.echo()
+    click.echo(click.style("=== GitHub Sync Agent — Setup Wizard ===", bold=True))
+    click.echo()
+
+    # ── 1. Check git ────────────────────────────────────────────────────────
+    git_ok, git_ver = setup.check_git()
+    if git_ok:
+        click.echo(f"  ✓ git found: {git_ver}")
+    else:
+        click.echo(click.style("  ✗ git is not installed.", fg="red"))
+        click.echo("    Install it with:  sudo apt-get install -y git")
+        sys.exit(1)
+
+    # ── 2. Check gh ─────────────────────────────────────────────────────────
+    gh_ok, gh_ver = setup.check_gh()
+    if gh_ok:
+        click.echo(f"  ✓ gh found: {gh_ver}")
+    else:
+        click.echo(click.style("  ✗ gh (GitHub CLI) is not installed.", fg="red"))
+        click.echo("    Install it with:  sudo apt-get install -y gh")
+        sys.exit(1)
+
+    # ── 3. GitHub authentication ─────────────────────────────────────────────
+    if setup.gh_authenticated():
+        github_user = setup.get_github_username()
+        click.echo(f"  ✓ Authenticated as: {github_user}")
+    else:
+        click.echo(click.style("  ✗ Not authenticated with GitHub.", fg="yellow"))
+        click.echo("    Running: gh auth login")
+        click.echo()
+        import subprocess
+        subprocess.run(["gh", "auth", "login"])
+        github_user = setup.get_github_username()
+        if not github_user:
+            click.echo(click.style("Authentication failed. Exiting.", fg="red"))
+            sys.exit(1)
+        click.echo(f"  ✓ Authenticated as: {github_user}")
+
+    click.echo()
+
+    # ── 4. Projects root ────────────────────────────────────────────────────
+    default_root = str(Path.home() / "projects")
+    projects_root = click.prompt(
+        "  Projects root directory (all subdirs will be synced)",
+        default=default_root,
+    )
+    projects_root = str(Path(projects_root).expanduser().resolve())
+    if not Path(projects_root).exists():
+        create = click.confirm(f"  Directory '{projects_root}' does not exist. Create it?", default=True)
+        if create:
+            Path(projects_root).mkdir(parents=True)
+            click.echo(f"  Created: {projects_root}")
+        else:
+            click.echo("  Aborted.")
+            sys.exit(1)
+
+    # ── 5. Default visibility ───────────────────────────────────────────────
+    visibility = click.prompt(
+        "  Default repo visibility for new GitHub repos",
+        type=click.Choice(["private", "public"]),
+        default="private",
+    )
+
+    click.echo()
+
+    # ── 6. SSH key setup ────────────────────────────────────────────────────
+    click.echo(click.style("  Setting up SSH key for GitHub...", bold=True))
+
+    if not setup.ssh_key_exists():
+        click.echo("  No SSH key found — generating one...")
+        if setup.generate_ssh_key():
+            click.echo("  ✓ SSH key generated")
+        else:
+            click.echo(click.style("  ✗ Failed to generate SSH key.", fg="red"))
+            sys.exit(1)
+    else:
+        click.echo("  ✓ SSH key already exists")
+
+    setup.add_github_host_key()
+
+    if not setup.ssh_key_on_github():
+        click.echo("  Uploading SSH key to GitHub...")
+        if setup.upload_ssh_key_to_github():
+            click.echo("  ✓ SSH key added to GitHub")
+        else:
+            click.echo(click.style("  ✗ Failed to upload SSH key.", fg="yellow"))
+            click.echo("    Run manually: gh ssh-key add ~/.ssh/id_ed25519.pub")
+    else:
+        click.echo("  ✓ SSH key already on GitHub")
+
+    click.echo()
+
+    # ── 7. Write config ─────────────────────────────────────────────────────
+    config_path = setup.write_config(github_user, projects_root, visibility)
+    click.echo(click.style(f"  ✓ Config written to: {config_path}", fg="green"))
+
+    click.echo()
+    click.echo(click.style("=== Setup complete! ===", bold=True))
+    click.echo()
+    click.echo("Next steps:")
+    click.echo(f"  github-sync status          # see all your projects")
+    click.echo(f"  github-sync sync --dry-run  # preview what will be synced")
+    click.echo(f"  github-sync sync            # sync everything to GitHub")
+    click.echo()
+
+
+# ---------------------------------------------------------------------------
+# Entry point
+# ---------------------------------------------------------------------------
+
+def main() -> None:
+    cli()

github_sync_agent-0.1.0/github_sync/config.py

@@ -0,0 +1,35 @@
+from pathlib import Path
+import yaml
+
+DEFAULT_CONFIG = Path.home() / ".config" / "github-sync" / "config.yaml"
+FALLBACK_CONFIG = Path(__file__).parent.parent / "config.yaml"
+
+
+def load(path: Path | None = None) -> dict:
+    """Load config from path, or search default locations."""
+    candidates = [path, DEFAULT_CONFIG, FALLBACK_CONFIG]
+    for p in candidates:
+        if p and p.exists():
+            with open(p) as f:
+                cfg = yaml.safe_load(f)
+            _apply_defaults(cfg)
+            return cfg
+    raise FileNotFoundError(
+        f"No config file found. Create one at {DEFAULT_CONFIG} or pass --config."
+    )
+
+
+def _apply_defaults(cfg: dict) -> None:
+    cfg.setdefault("schedule_time", "02:00")
+    cfg.setdefault("default_visibility", "private")
+    cfg.setdefault("auto_commit_message", "chore: auto-sync")
+    cfg.setdefault("exclude", [])
+    cfg.setdefault("log_file", str(Path.home() / ".local" / "share" / "github-sync" / "github-sync.log"))
+    cfg.setdefault("log_level", "INFO")
+    # Expand ~ in projects_root
+    if "projects_root" in cfg:
+        cfg["projects_root"] = str(Path(cfg["projects_root"]).expanduser())
+
+    for key in ("github_user", "projects_root"):
+        if not cfg.get(key):
+            raise ValueError(f"Missing required config key: '{key}'")

github_sync_agent-0.1.0/github_sync/setup.py

@@ -0,0 +1,146 @@
+"""
+Setup helpers used by `github-sync init`.
+Checks prerequisites, detects credentials, sets up SSH.
+"""
+
+import shutil
+import subprocess
+from pathlib import Path
+
+
+# ---------------------------------------------------------------------------
+# Dependency checks
+# ---------------------------------------------------------------------------
+
+def check_git() -> tuple[bool, str]:
+    """Returns (installed, version_string)."""
+    if not shutil.which("git"):
+        return False, ""
+    result = subprocess.run(["git", "--version"], capture_output=True, text=True)
+    return True, result.stdout.strip()
+
+
+def check_gh() -> tuple[bool, str]:
+    """Returns (installed, version_string)."""
+    if not shutil.which("gh"):
+        return False, ""
+    result = subprocess.run(["gh", "--version"], capture_output=True, text=True)
+    return True, result.stdout.splitlines()[0].strip()
+
+
+def gh_authenticated() -> bool:
+    result = subprocess.run(["gh", "auth", "status"], capture_output=True, text=True)
+    return result.returncode == 0
+
+
+def get_github_username() -> str | None:
+    """Detect the currently authenticated GitHub username."""
+    result = subprocess.run(
+        ["gh", "api", "user", "--jq", ".login"],
+        capture_output=True, text=True,
+    )
+    if result.returncode == 0:
+        return result.stdout.strip()
+    return None
+
+
+# ---------------------------------------------------------------------------
+# SSH helpers
+# ---------------------------------------------------------------------------
+
+DEFAULT_KEY = Path.home() / ".ssh" / "id_ed25519"
+
+
+def ssh_key_exists() -> bool:
+    return DEFAULT_KEY.exists()
+
+
+def generate_ssh_key(passphrase: str = "") -> bool:
+    result = subprocess.run(
+        ["ssh-keygen", "-t", "ed25519", "-C", "github-sync", "-f", str(DEFAULT_KEY), "-N", passphrase],
+        capture_output=True, text=True,
+    )
+    return result.returncode == 0
+
+
+def add_github_host_key() -> bool:
+    result = subprocess.run(
+        ["ssh-keyscan", "-t", "ed25519", "github.com"],
+        capture_output=True, text=True,
+    )
+    if result.returncode != 0:
+        return False
+    known_hosts = Path.home() / ".ssh" / "known_hosts"
+    known_hosts.parent.mkdir(mode=0o700, exist_ok=True)
+    existing = known_hosts.read_text() if known_hosts.exists() else ""
+    if "github.com" not in existing:
+        with open(known_hosts, "a") as f:
+            f.write(result.stdout)
+    return True
+
+
+def ssh_key_on_github() -> bool:
+    """Test if the current SSH key authenticates to GitHub."""
+    result = subprocess.run(
+        ["ssh", "-T", "-o", "BatchMode=yes", "-o", "StrictHostKeyChecking=no", "git@github.com"],
+        capture_output=True, text=True,
+    )
+    return "successfully authenticated" in (result.stdout + result.stderr)
+
+
+def upload_ssh_key_to_github(title: str = "github-sync") -> bool:
+    pub_key = Path(str(DEFAULT_KEY) + ".pub")
+    if not pub_key.exists():
+        return False
+    result = subprocess.run(
+        ["gh", "ssh-key", "add", str(pub_key), "--title", title],
+        capture_output=True, text=True,
+    )
+    return result.returncode == 0
+
+
+# ---------------------------------------------------------------------------
+# Config writer
+# ---------------------------------------------------------------------------
+
+CONFIG_DIR = Path.home() / ".config" / "github-sync"
+CONFIG_PATH = CONFIG_DIR / "config.yaml"
+
+CONFIG_TEMPLATE = """\
+# GitHub Sync Agent — configuration
+# Generated by `github-sync init`
+
+github_user: {github_user}
+
+# Root folder — every subdirectory here is treated as a project to sync
+projects_root: {projects_root}
+
+# Daily schedule time (used by the systemd timer / cron)
+schedule_time: "02:00"
+
+# Default visibility for newly created GitHub repos: private | public
+default_visibility: {visibility}
+
+# Commit message used for auto-commits
+auto_commit_message: "chore: auto-sync"
+
+# Project directories to skip (names only, not full paths)
+exclude: []
+
+# Logging
+log_file: {log_file}
+log_level: INFO
+"""
+
+
+def write_config(github_user: str, projects_root: str, visibility: str) -> Path:
+    CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+    log_file = str(Path.home() / ".local" / "share" / "github-sync" / "github-sync.log")
+    content = CONFIG_TEMPLATE.format(
+        github_user=github_user,
+        projects_root=projects_root,
+        visibility=visibility,
+        log_file=log_file,
+    )
+    CONFIG_PATH.write_text(content)
+    return CONFIG_PATH

github_sync_agent-0.1.0/github_sync_agent.egg-info/PKG-INFO

@@ -0,0 +1,132 @@
+Metadata-Version: 2.4
+Name: github-sync-agent
+Version: 0.1.0
+Summary: Sync all your local projects to GitHub automatically
+Author: yuvalavni
+License: MIT
+Project-URL: Homepage, https://github.com/yuvalavni/Agents
+Project-URL: Repository, https://github.com/yuvalavni/Agents
+Keywords: github,git,sync,backup,automation,cli
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Environment :: Console
+Classifier: Topic :: Software Development :: Version Control :: Git
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: click>=8.0
+
+# GitHub Sync Agent
+
+Automatically syncs every project under `/home/yuval/projects` to GitHub (`github.com/yuvalavni`).
+
+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 at **02:00** via a systemd user timer, and on-demand via CLI.
+
+---
+
+## Directory layout
+
+```
+agents/github-sync/
+├── github_sync_agent.py   # Main script
+├── config.yaml            # GitHub user, projects root, schedule, exclusions
+├── requirements.txt
+├── install.sh             # One-time setup
+├── systemd/
+│   ├── github-sync.service
+│   └── github-sync.timer
+└── logs/
+    └── github-sync.log
+```
+
+---
+
+## Quick start
+
+```bash
+cd /home/yuval/projects/Agents/agents/github-sync
+
+# 1. Install (once)
+bash install.sh
+
+# 2. Dry run
+.venv/bin/python github_sync_agent.py --dry-run
+
+# 3. Sync for real
+.venv/bin/python github_sync_agent.py
+```
+
+---
+
+## Configuration (`config.yaml`)
+
+| Key | Default | Description |
+|-----|---------|-------------|
+| `github_user` | `yuvalavni` | GitHub username |
+| `projects_root` | `/home/yuval/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` | `logs/github-sync.log` | Log file path |
+| `log_level` | `INFO` | `DEBUG` / `INFO` / `WARNING` / `ERROR` |
+
+### Excluding a project
+
+```yaml
+exclude:
+  - SomePrivateProject
+  - TempExperiment
+```
+
+---
+
+## CLI reference
+
+```bash
+# Sync all projects
+.venv/bin/python github_sync_agent.py
+
+# Sync a single project
+.venv/bin/python github_sync_agent.py --project Agents
+
+# Preview without making any changes
+.venv/bin/python github_sync_agent.py --dry-run
+
+# Show status of all projects (git, remote, changes, GitHub)
+.venv/bin/python github_sync_agent.py --status
+```
+
+---
+
+## Systemd
+
+```bash
+# Trigger immediately
+systemctl --user start github-sync.service
+
+# Check next scheduled run
+systemctl --user list-timers github-sync.timer
+
+# View live logs
+journalctl --user -u github-sync.service -f
+
+# Disable daily timer
+systemctl --user disable --now github-sync.timer
+```
+
+---
+
+## Prerequisites
+
+- `git` installed
+- `gh` installed and authenticated (`gh auth status`)
+- SSH key added to GitHub (`gh ssh-key list`)

github_sync_agent-0.1.0/github_sync_agent.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+README.md
+pyproject.toml
+github_sync/__init__.py
+github_sync/agent.py
+github_sync/cli.py
+github_sync/config.py
+github_sync/setup.py
+github_sync_agent.egg-info/PKG-INFO
+github_sync_agent.egg-info/SOURCES.txt
+github_sync_agent.egg-info/dependency_links.txt
+github_sync_agent.egg-info/entry_points.txt
+github_sync_agent.egg-info/requires.txt
+github_sync_agent.egg-info/top_level.txt

github_sync_agent-0.1.0/github_sync_agent.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

github_sync_agent-0.1.0/github_sync_agent.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+github-sync = github_sync.cli:main

github_sync_agent-0.1.0/github_sync_agent.egg-info/requires.txt

@@ -0,0 +1,2 @@
+pyyaml>=6.0
+click>=8.0

github_sync_agent-0.1.0/github_sync_agent.egg-info/top_level.txt

@@ -0,0 +1 @@
+github_sync

github_sync_agent-0.1.0/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["setuptools>=42", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "github-sync-agent"
+version = "0.1.0"
+description = "Sync all your local projects to GitHub automatically"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [
+    { name = "yuvalavni" }
+]
+keywords = ["github", "git", "sync", "backup", "automation", "cli"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: POSIX :: Linux",
+    "Environment :: Console",
+    "Topic :: Software Development :: Version Control :: Git",
+]
+dependencies = [
+    "pyyaml>=6.0",
+    "click>=8.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/yuvalavni/Agents"
+Repository = "https://github.com/yuvalavni/Agents"
+
+[project.scripts]
+github-sync = "github_sync.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["github_sync*"]

github_sync_agent-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+