gh-agent-sync 0.1.0__tar.gz

gh_agent_sync-0.1.0/PKG-INFO

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: gh-agent-sync
+Version: 0.1.0
+Summary: Link agents and skills from awesome-copilot to your local repository. Supports MCP-based git operations.
+License: MIT
+Project-URL: Homepage, https://github.com/msandeep12/gh-agent-sync
+Project-URL: Repository, https://github.com/msandeep12/gh-agent-sync
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# Copilot Linker
+
+A cross-platform Python utility to link agents and skills from the [awesome-copilot](https://github.com/github/awesome-copilot) repository to any local git repository.
+
+## Installation
+
+Install from source:
+
+```bash
+pip install .
+```
+
+Or for development:
+
+```bash
+pip install -e .
+```
+
+From PyPI (once published):
+
+```bash
+pip install gh-agent-sync
+```
+
+## Usage
+
+Run the utility from the root of your git repository:
+
+### Link Agents and Skills
+
+```bash
+gh-agent-sync link
+```
+
+Or specify a custom repository:
+
+```bash
+gh-agent-sync link --url https://github.com/your-org/your-agents-repo
+```
+
+This will:
+- Clone or update the awesome-copilot repository into `.github/awesome-copilot`
+- Create symbolic links (or copies if symlinks fail) to `.github/agents` and `.github/skills`
+- Add the linked paths to `.gitignore` to prevent them from being committed
+
+### Undo Linking
+
+```bash
+gh-agent-sync undo
+```
+
+This will:
+- Remove the `.github/agents` and `.github/skills` directories
+- Remove the cloned `.github/awesome-copilot` repository
+
+## Development
+
+### Building
+
+To build the package:
+
+```bash
+python -m build
+```
+
+### Publishing
+
+1. Create a release on GitHub
+2. The CI/CD workflow will automatically build and publish to PyPI
+
+Make sure to set up PyPI API tokens in the repository secrets if needed.
+
+## What it does
+
+- Checks if the current directory is a git repository
+- Clones or updates the awesome-copilot repository into `.github/awesome-copilot`
+- Creates symbolic links (or copies if symlinks fail):
+  - `.github/agents` → `.github/awesome-copilot/agents`
+  - `.github/skills` → `.github/awesome-copilot/skills`
+- Adds linked paths to `.gitignore`
+
+This allows you to use the agents and skills from awesome-copilot in your repository without copying the files directly.
+
+## Requirements
+
+- Python 3.8+
+- Git
+- Internet connection for cloning the repository
+
+## Notes
+
+- On systems where symlinks are not supported or require special permissions, the utility will fall back to copying the directories.
+- The utility creates links/copies, so changes in the awesome-copilot repo will be reflected in your links (after updating with `git pull` in the cloned directory).
+
+## Architecture
+
+### MCP Integration
+
+This tool uses a **Model Context Protocol (MCP)** based git server for all git operations. This provides:
+
+- Type-safe git operations
+- Better error handling
+- Easier testing and mocking
+- Potential for distributed git operations
+- Integration with AI agents via MCP
+
+The `GitMCPServer` class in `src/gh_agent_sync/git_mcp.py` provides standardized interfaces for:
+- `is_git_repo()` - Check if in a git repository
+- `clone()` - Clone a repository
+- `pull()` - Pull updates
+- `add()` - Stage files
+- `commit()` - Commit changes
+- `push()` - Push to remote
+
+## Contributing
+
+We use a pull request workflow with automated versioning and release management. Please see [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines on:
+
+- How to create pull requests
+- Conventional commit message style
+- Automated versioning and release process
+
+All commits should follow the [Conventional Commits](https://www.conventionalcommits.org/) specification.

gh_agent_sync-0.1.0/README.md

@@ -0,0 +1,123 @@
+# Copilot Linker
+
+A cross-platform Python utility to link agents and skills from the [awesome-copilot](https://github.com/github/awesome-copilot) repository to any local git repository.
+
+## Installation
+
+Install from source:
+
+```bash
+pip install .
+```
+
+Or for development:
+
+```bash
+pip install -e .
+```
+
+From PyPI (once published):
+
+```bash
+pip install gh-agent-sync
+```
+
+## Usage
+
+Run the utility from the root of your git repository:
+
+### Link Agents and Skills
+
+```bash
+gh-agent-sync link
+```
+
+Or specify a custom repository:
+
+```bash
+gh-agent-sync link --url https://github.com/your-org/your-agents-repo
+```
+
+This will:
+- Clone or update the awesome-copilot repository into `.github/awesome-copilot`
+- Create symbolic links (or copies if symlinks fail) to `.github/agents` and `.github/skills`
+- Add the linked paths to `.gitignore` to prevent them from being committed
+
+### Undo Linking
+
+```bash
+gh-agent-sync undo
+```
+
+This will:
+- Remove the `.github/agents` and `.github/skills` directories
+- Remove the cloned `.github/awesome-copilot` repository
+
+## Development
+
+### Building
+
+To build the package:
+
+```bash
+python -m build
+```
+
+### Publishing
+
+1. Create a release on GitHub
+2. The CI/CD workflow will automatically build and publish to PyPI
+
+Make sure to set up PyPI API tokens in the repository secrets if needed.
+
+## What it does
+
+- Checks if the current directory is a git repository
+- Clones or updates the awesome-copilot repository into `.github/awesome-copilot`
+- Creates symbolic links (or copies if symlinks fail):
+  - `.github/agents` → `.github/awesome-copilot/agents`
+  - `.github/skills` → `.github/awesome-copilot/skills`
+- Adds linked paths to `.gitignore`
+
+This allows you to use the agents and skills from awesome-copilot in your repository without copying the files directly.
+
+## Requirements
+
+- Python 3.8+
+- Git
+- Internet connection for cloning the repository
+
+## Notes
+
+- On systems where symlinks are not supported or require special permissions, the utility will fall back to copying the directories.
+- The utility creates links/copies, so changes in the awesome-copilot repo will be reflected in your links (after updating with `git pull` in the cloned directory).
+
+## Architecture
+
+### MCP Integration
+
+This tool uses a **Model Context Protocol (MCP)** based git server for all git operations. This provides:
+
+- Type-safe git operations
+- Better error handling
+- Easier testing and mocking
+- Potential for distributed git operations
+- Integration with AI agents via MCP
+
+The `GitMCPServer` class in `src/gh_agent_sync/git_mcp.py` provides standardized interfaces for:
+- `is_git_repo()` - Check if in a git repository
+- `clone()` - Clone a repository
+- `pull()` - Pull updates
+- `add()` - Stage files
+- `commit()` - Commit changes
+- `push()` - Push to remote
+
+## Contributing
+
+We use a pull request workflow with automated versioning and release management. Please see [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines on:
+
+- How to create pull requests
+- Conventional commit message style
+- Automated versioning and release process
+
+All commits should follow the [Conventional Commits](https://www.conventionalcommits.org/) specification.

gh_agent_sync-0.1.0/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "gh-agent-sync"
+version = "0.1.0"
+description = "Link agents and skills from awesome-copilot to your local repository. Supports MCP-based git operations."
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.8"
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Operating System :: OS Independent",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/msandeep12/gh-agent-sync"
+Repository = "https://github.com/msandeep12/gh-agent-sync"
+
+[project.scripts]
+gh-agent-sync = "gh_agent_sync.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-dir]
+"" = "src"

gh_agent_sync-0.1.0/setup.cfg

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

gh_agent_sync-0.1.0/src/gh_agent_sync/__main__.py

@@ -0,0 +1,6 @@
+"""Entry point for gh-agent-sync package when run as a module."""
+
+from gh_agent_sync.cli import main
+
+if __name__ == "__main__":
+    main()

gh_agent_sync-0.1.0/src/gh_agent_sync/cli.py

@@ -0,0 +1,158 @@
+#!/usr/bin/env python3
+"""
+Copilot Linker - Link agents and skills from awesome-copilot to local .github/
+"""
+
+import os
+import sys
+import shutil
+import argparse
+import tempfile
+from pathlib import Path
+from .git_mcp import GitMCPServer
+
+
+def is_git_repo():
+    """Check if current directory is a git repository."""
+    return GitMCPServer.is_git_repo()
+
+
+def clone_or_update_awesome_copilot(repo_url):
+    """Clone the repository to a temporary directory and return the path.
+    
+    This uses a temporary directory to keep the project directory clean.
+    The full repository is not stored in the project.
+    """
+    temp_dir = tempfile.mkdtemp(prefix="gh-agent-sync-")
+    temp_path = Path(temp_dir)
+    
+    print(f"Cloning repository to temporary directory...")
+    success, message = GitMCPServer.clone(repo_url, str(temp_path))
+    if not success:
+        print(f"Error: {message}")
+        shutil.rmtree(temp_path, ignore_errors=True)
+        return None
+    else:
+        print(message)
+    
+    return temp_path
+
+
+def create_link_or_copy(source, target):
+    """Create a symlink or copy if symlink fails."""
+    source = Path(source)
+    target = Path(target)
+
+    if target.exists():
+        print(f"{target} already exists")
+        return True
+
+    try:
+        # Try to create symlink
+        os.symlink(source, target, target_is_directory=True)
+        print(f"Created symlink: {target} -> {source}")
+        return True
+    except OSError as e:
+        print(f"Symlink failed ({e}), copying instead...")
+        try:
+            shutil.copytree(source, target)
+            print(f"Copied: {source} -> {target}")
+            return True
+        except Exception as e:
+            print(f"Copy failed: {e}")
+            return False
+
+
+def remove_link(target):
+    """Remove a link or copy."""
+    target = Path(target)
+    if target.exists():
+        if target.is_dir():
+            shutil.rmtree(target)
+        else:
+            target.unlink()
+        print(f"Removed {target}")
+    else:
+        print(f"{target} does not exist")
+
+
+def add_to_gitignore():
+    """Add linked paths to .gitignore."""
+    gitignore = Path(".gitignore")
+    entries = [".github/agents", ".github/skills"]
+
+    if gitignore.exists():
+        with open(gitignore, "r") as f:
+            content = f.read()
+    else:
+        content = ""
+
+    added = False
+    for entry in entries:
+        if entry not in content:
+            content += f"\n{entry}"
+            added = True
+
+    if added:
+        with open(gitignore, "w") as f:
+            f.write(content)
+        print("Added entries to .gitignore")
+
+
+def link(repo_url):
+    """Link agents and skills."""
+    # Ensure .github directory exists
+    Path(".github").mkdir(exist_ok=True)
+
+    # Clone repository to temporary directory
+    temp_repo = clone_or_update_awesome_copilot(repo_url)
+    if not temp_repo:
+        print("Failed to clone repository")
+        sys.exit(1)
+
+    try:
+        # Create links from temporary directory
+        success = True
+        success &= create_link_or_copy(temp_repo / "agents", Path(".github/agents"))
+        success &= create_link_or_copy(temp_repo / "skills", Path(".github/skills"))
+
+        if success:
+            add_to_gitignore()
+            print("Done! Agents and skills are now linked to your repository.")
+        else:
+            print("Some links failed to create.")
+            sys.exit(1)
+    finally:
+        # Clean up temporary directory
+        shutil.rmtree(temp_repo, ignore_errors=True)
+        print(f"Cleaned up temporary directory")
+
+
+def undo():
+    """Undo the linking."""
+    remove_link(".github/agents")
+    remove_link(".github/skills")
+    
+    print("Undo complete. The agents and skills links have been removed.")
+
+
+def main():
+    """Main function."""
+    parser = argparse.ArgumentParser(description="Link or undo linking of agents and skills from a repository")
+    parser.add_argument("command", choices=["link", "undo"], help="Command to run: link or undo")
+    parser.add_argument("--url", default="https://github.com/github/awesome-copilot", help="URL of the repository containing agents and skills (default: awesome-copilot)")
+
+    args = parser.parse_args()
+
+    if not is_git_repo():
+        print("Error: Not in a git repository")
+        sys.exit(1)
+
+    if args.command == "link":
+        link(args.url)
+    elif args.command == "undo":
+        undo()
+
+
+if __name__ == "__main__":
+    main()

gh_agent_sync-0.1.0/src/gh_agent_sync/git_mcp.py

@@ -0,0 +1,131 @@
+#!/usr/bin/env python3
+"""
+Git MCP - Git operations via Model Context Protocol
+"""
+
+import subprocess
+from pathlib import Path
+from typing import Tuple
+
+
+class GitMCPServer:
+    """Simple Git MCP Server for git operations."""
+
+    @staticmethod
+    def is_git_repo() -> bool:
+        """Check if current directory is a git repository."""
+        try:
+            subprocess.run(
+                ["git", "rev-parse", "--git-dir"],
+                check=True,
+                capture_output=True,
+                text=True
+            )
+            return True
+        except subprocess.CalledProcessError:
+            return False
+
+    @staticmethod
+    def clone(repo_url: str, target_dir: str) -> Tuple[bool, str]:
+        """Clone a git repository.
+        
+        Args:
+            repo_url: URL of the repository to clone
+            target_dir: Target directory for cloning
+            
+        Returns:
+            Tuple of (success, message)
+        """
+        try:
+            subprocess.run(
+                ["git", "clone", repo_url, target_dir],
+                check=True,
+                capture_output=True,
+                text=True
+            )
+            return True, f"Cloned {repo_url} to {target_dir}"
+        except subprocess.CalledProcessError as e:
+            return False, f"Clone failed: {e.stderr}"
+
+    @staticmethod
+    def pull(repo_dir: str) -> Tuple[bool, str]:
+        """Pull updates from a git repository.
+        
+        Args:
+            repo_dir: Directory of the repository
+            
+        Returns:
+            Tuple of (success, message)
+        """
+        try:
+            result = subprocess.run(
+                ["git", "-C", repo_dir, "pull"],
+                check=True,
+                capture_output=True,
+                text=True
+            )
+            return True, f"Updated repository: {result.stdout}"
+        except subprocess.CalledProcessError as e:
+            return False, f"Pull failed: {e.stderr}"
+
+    @staticmethod
+    def add(files: list, repo_dir: str = ".") -> Tuple[bool, str]:
+        """Stage files in git.
+        
+        Args:
+            files: List of files to stage
+            repo_dir: Directory of the repository
+            
+        Returns:
+            Tuple of (success, message)
+        """
+        try:
+            cmd = ["git", "-C", repo_dir, "add"] + files
+            subprocess.run(cmd, check=True, capture_output=True, text=True)
+            return True, f"Staged {len(files)} file(s)"
+        except subprocess.CalledProcessError as e:
+            return False, f"Add failed: {e.stderr}"
+
+    @staticmethod
+    def commit(message: str, repo_dir: str = ".") -> Tuple[bool, str]:
+        """Commit changes to git.
+        
+        Args:
+            message: Commit message
+            repo_dir: Directory of the repository
+            
+        Returns:
+            Tuple of (success, message)
+        """
+        try:
+            result = subprocess.run(
+                ["git", "-C", repo_dir, "commit", "-m", message],
+                check=True,
+                capture_output=True,
+                text=True
+            )
+            return True, f"Committed: {result.stdout}"
+        except subprocess.CalledProcessError as e:
+            return False, f"Commit failed: {e.stderr}"
+
+    @staticmethod
+    def push(branch: str = "main", repo_dir: str = ".") -> Tuple[bool, str]:
+        """Push changes to remote repository.
+        
+        Args:
+            branch: Branch to push
+            repo_dir: Directory of the repository
+            
+        Returns:
+            Tuple of (success, message)
+        """
+        try:
+            result = subprocess.run(
+                ["git", "-C", repo_dir, "push", "origin", branch],
+                check=True,
+                capture_output=True,
+                text=True
+            )
+            return True, f"Pushed: {result.stdout}"
+        except subprocess.CalledProcessError as e:
+            return False, f"Push failed: {e.stderr}"

gh_agent_sync-0.1.0/src/gh_agent_sync.egg-info/PKG-INFO

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: gh-agent-sync
+Version: 0.1.0
+Summary: Link agents and skills from awesome-copilot to your local repository. Supports MCP-based git operations.
+License: MIT
+Project-URL: Homepage, https://github.com/msandeep12/gh-agent-sync
+Project-URL: Repository, https://github.com/msandeep12/gh-agent-sync
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# Copilot Linker
+
+A cross-platform Python utility to link agents and skills from the [awesome-copilot](https://github.com/github/awesome-copilot) repository to any local git repository.
+
+## Installation
+
+Install from source:
+
+```bash
+pip install .
+```
+
+Or for development:
+
+```bash
+pip install -e .
+```
+
+From PyPI (once published):
+
+```bash
+pip install gh-agent-sync
+```
+
+## Usage
+
+Run the utility from the root of your git repository:
+
+### Link Agents and Skills
+
+```bash
+gh-agent-sync link
+```
+
+Or specify a custom repository:
+
+```bash
+gh-agent-sync link --url https://github.com/your-org/your-agents-repo
+```
+
+This will:
+- Clone or update the awesome-copilot repository into `.github/awesome-copilot`
+- Create symbolic links (or copies if symlinks fail) to `.github/agents` and `.github/skills`
+- Add the linked paths to `.gitignore` to prevent them from being committed
+
+### Undo Linking
+
+```bash
+gh-agent-sync undo
+```
+
+This will:
+- Remove the `.github/agents` and `.github/skills` directories
+- Remove the cloned `.github/awesome-copilot` repository
+
+## Development
+
+### Building
+
+To build the package:
+
+```bash
+python -m build
+```
+
+### Publishing
+
+1. Create a release on GitHub
+2. The CI/CD workflow will automatically build and publish to PyPI
+
+Make sure to set up PyPI API tokens in the repository secrets if needed.
+
+## What it does
+
+- Checks if the current directory is a git repository
+- Clones or updates the awesome-copilot repository into `.github/awesome-copilot`
+- Creates symbolic links (or copies if symlinks fail):
+  - `.github/agents` → `.github/awesome-copilot/agents`
+  - `.github/skills` → `.github/awesome-copilot/skills`
+- Adds linked paths to `.gitignore`
+
+This allows you to use the agents and skills from awesome-copilot in your repository without copying the files directly.
+
+## Requirements
+
+- Python 3.8+
+- Git
+- Internet connection for cloning the repository
+
+## Notes
+
+- On systems where symlinks are not supported or require special permissions, the utility will fall back to copying the directories.
+- The utility creates links/copies, so changes in the awesome-copilot repo will be reflected in your links (after updating with `git pull` in the cloned directory).
+
+## Architecture
+
+### MCP Integration
+
+This tool uses a **Model Context Protocol (MCP)** based git server for all git operations. This provides:
+
+- Type-safe git operations
+- Better error handling
+- Easier testing and mocking
+- Potential for distributed git operations
+- Integration with AI agents via MCP
+
+The `GitMCPServer` class in `src/gh_agent_sync/git_mcp.py` provides standardized interfaces for:
+- `is_git_repo()` - Check if in a git repository
+- `clone()` - Clone a repository
+- `pull()` - Pull updates
+- `add()` - Stage files
+- `commit()` - Commit changes
+- `push()` - Push to remote
+
+## Contributing
+
+We use a pull request workflow with automated versioning and release management. Please see [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines on:
+
+- How to create pull requests
+- Conventional commit message style
+- Automated versioning and release process
+
+All commits should follow the [Conventional Commits](https://www.conventionalcommits.org/) specification.

gh_agent_sync-0.1.0/src/gh_agent_sync.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+src/gh_agent_sync/__init__.py
+src/gh_agent_sync/__main__.py
+src/gh_agent_sync/cli.py
+src/gh_agent_sync/git_mcp.py
+src/gh_agent_sync.egg-info/PKG-INFO
+src/gh_agent_sync.egg-info/SOURCES.txt
+src/gh_agent_sync.egg-info/dependency_links.txt
+src/gh_agent_sync.egg-info/entry_points.txt
+src/gh_agent_sync.egg-info/top_level.txt

gh_agent_sync-0.1.0/src/gh_agent_sync.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

gh_agent_sync-0.1.0/src/gh_agent_sync.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+gh-agent-sync = gh_agent_sync.cli:main

gh_agent_sync-0.1.0/src/gh_agent_sync.egg-info/top_level.txt

@@ -0,0 +1 @@
+gh_agent_sync