agr 0.4.0__py3-none-any.whl

agr/github.py

@@ -0,0 +1,95 @@
+"""GitHub CLI integration for creating and pushing repositories."""
+
+import subprocess
+from pathlib import Path
+
+
+def check_gh_cli() -> bool:
+    """Check if GitHub CLI is available and authenticated.
+
+    Returns True if gh CLI is installed and authenticated, False otherwise.
+    """
+    try:
+        result = subprocess.run(
+            ["gh", "auth", "status"],
+            capture_output=True,
+            text=True,
+            timeout=30,
+        )
+        return result.returncode == 0
+    except (FileNotFoundError, subprocess.TimeoutExpired):
+        return False
+
+
+def get_github_username() -> str | None:
+    """Get the authenticated GitHub username.
+
+    Returns the username if authenticated, None otherwise.
+    """
+    try:
+        result = subprocess.run(
+            ["gh", "api", "user", "--jq", ".login"],
+            capture_output=True,
+            text=True,
+            check=True,
+            timeout=30,
+        )
+        return result.stdout.strip()
+    except (subprocess.CalledProcessError, FileNotFoundError, subprocess.TimeoutExpired):
+        return None
+
+
+def create_github_repo(path: Path, repo_name: str = "agent-resources") -> str | None:
+    """Create a GitHub repository and push the local repo.
+
+    Args:
+        path: Path to the local git repository
+        repo_name: Name for the GitHub repository (default: agent-resources)
+
+    Returns:
+        The GitHub repo URL if successful, None otherwise.
+    """
+    try:
+        # Create repo on GitHub (public by default)
+        subprocess.run(
+            [
+                "gh",
+                "repo",
+                "create",
+                repo_name,
+                "--public",
+                "--source",
+                str(path),
+                "--push",
+            ],
+            capture_output=True,
+            text=True,
+            check=True,
+            timeout=120,
+        )
+
+        # Construct URL from username
+        username = get_github_username()
+        if username:
+            return f"https://github.com/{username}/{repo_name}"
+
+        return None
+    except (subprocess.CalledProcessError, FileNotFoundError, subprocess.TimeoutExpired):
+        return None
+
+
+def repo_exists(repo_name: str = "agent-resources") -> bool:
+    """Check if a repository with the given name already exists.
+
+    Returns True if the repo exists, False otherwise.
+    """
+    try:
+        result = subprocess.run(
+            ["gh", "repo", "view", repo_name],
+            capture_output=True,
+            text=True,
+            timeout=30,
+        )
+        return result.returncode == 0
+    except (FileNotFoundError, subprocess.TimeoutExpired):
+        return False

agr/scaffold.py

@@ -0,0 +1,194 @@
+"""Scaffolding functions for creating agent-resources repository structure."""
+
+import subprocess
+from pathlib import Path
+
+HELLO_SKILL = """\
+---
+name: hello-world
+description: A simple example skill that demonstrates Claude Code skill structure
+---
+
+# Hello World Skill
+
+This is a demonstration skill showing how skills work.
+
+## When to Use
+
+Apply this skill when the user asks you to say hello or demonstrate skills.
+
+## Instructions
+
+Respond with a friendly greeting explaining this came from a skill.
+"""
+
+HELLO_COMMAND = """\
+---
+description: Say hello - example slash command
+---
+
+When the user runs /hello, respond with a friendly greeting.
+Explain that this is an example command from their agent-resources repo.
+"""
+
+HELLO_AGENT = """\
+---
+description: Example subagent that greets users
+---
+
+You are a friendly greeter subagent.
+When invoked, introduce yourself and explain that you're an example agent
+from the user's agent-resources repository.
+"""
+
+README_TEMPLATE = """\
+# agent-resources
+
+My personal collection of Claude Code skills, commands, and agents.
+
+## Structure
+
+```
+.claude/
+├── skills/       # Skill directories with SKILL.md
+├── commands/     # Slash command .md files
+└── agents/       # Subagent .md files
+```
+
+## Usage
+
+Others can install my resources using:
+
+```bash
+# Install a skill
+agr add skill {username}/hello-world
+
+# Install a command
+agr add command {username}/hello
+
+# Install an agent
+agr add agent {username}/hello-agent
+```
+
+## Adding Resources
+
+- **Skills**: Create a directory in `.claude/skills/<name>/` with a `SKILL.md` file
+- **Commands**: Create a `.md` file in `.claude/commands/`
+- **Agents**: Create a `.md` file in `.claude/agents/`
+
+## Learn More
+
+- [agent-resources documentation](https://github.com/kasperjunge/agent-resources)
+"""
+
+GITIGNORE = """\
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+.env
+.venv/
+venv/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+"""
+
+
+def scaffold_repo(path: Path) -> None:
+    """Create the complete agent-resources directory structure."""
+    path.mkdir(parents=True, exist_ok=True)
+
+    # Create .claude directory structure
+    claude_dir = path / ".claude"
+    (claude_dir / "skills" / "hello-world").mkdir(parents=True, exist_ok=True)
+    (claude_dir / "commands").mkdir(parents=True, exist_ok=True)
+    (claude_dir / "agents").mkdir(parents=True, exist_ok=True)
+
+
+def write_starter_skill(path: Path) -> None:
+    """Write the hello-world example skill."""
+    skill_path = path / ".claude" / "skills" / "hello-world" / "SKILL.md"
+    skill_path.write_text(HELLO_SKILL)
+
+
+def write_starter_command(path: Path) -> None:
+    """Write the hello example command."""
+    command_path = path / ".claude" / "commands" / "hello.md"
+    command_path.write_text(HELLO_COMMAND)
+
+
+def write_starter_agent(path: Path) -> None:
+    """Write the hello-agent example agent."""
+    agent_path = path / ".claude" / "agents" / "hello-agent.md"
+    agent_path.write_text(HELLO_AGENT)
+
+
+def write_readme(path: Path, username: str = "<username>", overwrite: bool = False) -> bool:
+    """Write the README.md file.
+
+    Returns True if file was written, False if skipped.
+    """
+    readme_path = path / "README.md"
+    if readme_path.exists() and not overwrite:
+        return False
+    readme_path.write_text(README_TEMPLATE.format(username=username))
+    return True
+
+
+def write_gitignore(path: Path, overwrite: bool = False) -> bool:
+    """Write the .gitignore file.
+
+    Returns True if file was written, False if skipped.
+    """
+    gitignore_path = path / ".gitignore"
+    if gitignore_path.exists() and not overwrite:
+        return False
+    gitignore_path.write_text(GITIGNORE)
+    return True
+
+
+def init_git(path: Path) -> bool:
+    """Initialize git repository and create initial commit.
+
+    Returns True if successful, False otherwise.
+    """
+    try:
+        subprocess.run(
+            ["git", "init"],
+            cwd=path,
+            check=True,
+            capture_output=True,
+        )
+        subprocess.run(
+            ["git", "add", "."],
+            cwd=path,
+            check=True,
+            capture_output=True,
+        )
+        subprocess.run(
+            ["git", "commit", "-m", "Initial commit: agent-resources repo scaffold"],
+            cwd=path,
+            check=True,
+            capture_output=True,
+        )
+        return True
+    except (subprocess.CalledProcessError, FileNotFoundError):
+        return False
+
+
+def create_agent_resources_repo(path: Path, username: str = "<username>") -> None:
+    """Create a complete agent-resources repository with all starter content."""
+    scaffold_repo(path)
+    write_starter_skill(path)
+    write_starter_command(path)
+    write_starter_agent(path)
+    write_readme(path, username)
+    write_gitignore(path)

agr-0.4.0.dist-info/METADATA

@@ -0,0 +1,17 @@
+Metadata-Version: 2.4
+Name: agr
+Version: 0.4.0
+Summary: Agent Resources - A package and project manager for AI agents.
+License-Expression: MIT
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Requires-Dist: rich>=13.0
+Requires-Dist: tomlkit>=0.12
+Requires-Dist: typer>=0.12
+Description-Content-Type: text/markdown
+
+# agr
+
+Agent resources for Claude Code.
+
+See [agent-resources](https://github.com/kasperjunge/agent-resources) for full documentation.

agr-0.4.0.dist-info/RECORD

@@ -0,0 +1,19 @@
+agr/__init__.py,sha256=fYcMcp7MndFbZQ-2FMd1zbDp3BdXJusC77WGZeVl-n4,113
+agr/config.py,sha256=V5VZzGFLkgxz_SyFzgHOW4OKBEow-Ehpqji9kHk7CZY,5090
+agr/exceptions.py,sha256=CljTHgTAz1H8OzGnP_F1sceqwfUwOdPoFquGQ5bPZ28,836
+agr/fetcher.py,sha256=-rEyhOInf4nhnP_-vZBPvkUQnyJDYdQdrGfA9P0o3lM,25493
+agr/github.py,sha256=IMh5Hd0dc8etxlZC-0bp5i_Hz6UBz1l-KW2VdX_9QMA,2671
+agr/scaffold.py,sha256=kJGUJbxEYZnk0KzGs24ZOj4mOk5Jv7xNdhmeFefaFVI,4805
+agr/cli/__init__.py,sha256=WHqEa_48pzU8CxERRx-6I6pZNPVACq5kf03UwB6BCTc,75
+agr/cli/add.py,sha256=Vt7x8Pj7n7kumcDCoFbav6HOpTDI3voL21pKojyvn9k,4307
+agr/cli/common.py,sha256=cu89nI1-3UjQxrAljdPxoJzdkdv5lV8rE0iHPc_io6M,36835
+agr/cli/init.py,sha256=_nINLB1VlEzlEUoVjCiyNmM0yrnLdq0Z0MAygA-UZfA,8113
+agr/cli/main.py,sha256=Dv-e9STwHKSctaFqd7CHIrs4W9jzBAVH-t1uN-FYE7Q,778
+agr/cli/remove.py,sha256=RSrUT01RbMFfS8ROsnZz3w07nu7tLVuRQGS4sF6PXKQ,4075
+agr/cli/run.py,sha256=RZGnNnCcvYycZShAAkt-pJbe8MhIQo7znCgmiFDHuHk,13353
+agr/cli/sync.py,sha256=PiOBYEC5IcUs9gm3te1rARAkhIdWGLtFaCTECN-RMfo,8276
+agr/cli/update.py,sha256=pvdY9ojC7B6kb8nREBvHrEGTOrjquNxvRjPzL6Fj8zo,4119
+agr-0.4.0.dist-info/METADATA,sha256=61fy56UUsEjJs9I3yafsMtK29VnHSMfr2DuMsusYfBs,452
+agr-0.4.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+agr-0.4.0.dist-info/entry_points.txt,sha256=uaxLTUZsmwId9vBBeKWQoqIxS6gnpYxyBX2TfncEqIg,64
+agr-0.4.0.dist-info/RECORD,,

agr-0.4.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

agr-0.4.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+agr = agr.cli.main:app
+agrx = agr.cli.run:app