agents-tool 0.1.0__py3-none-any.whl

agents_tool/__init__.py

@@ -0,0 +1,3 @@
+"""Agents Tool - CLI for managing AI agents, skills and harness."""
+
+__version__ = "0.1.0"

agents_tool/cli.py

@@ -0,0 +1,36 @@
+"""CLI entry point for agents-tool."""
+
+import click
+
+from . import __version__
+
+
+@click.group()
+@click.version_option(version=__version__)
+def main():
+    """Agents Tool - Manage AI agents, skills and harness."""
+    pass
+
+
+@main.command()
+def init():
+    """Initialize agents-tool configuration."""
+    from .config import init_config
+
+    init_config()
+
+
+@main.command()
+def gou():
+    """Get or update agents from configured repos."""
+    from .git import process_repos
+
+    process_repos()
+
+
+@main.command()
+def list():
+    """List installed agents, skills and harness."""
+    from .registry import list_installed
+
+    list_installed()

agents_tool/config.py

@@ -0,0 +1,59 @@
+"""Config management for agents-tool."""
+
+import os
+from pathlib import Path
+
+import click
+import yaml
+
+# Local config (in current directory)
+CONFIG_DIR = Path.cwd() / ".agents"
+CONFIG_FILE = CONFIG_DIR / "config.yaml"
+LOCAL_DIR = Path.cwd() / ".agents"
+REPOS_DIR = LOCAL_DIR / "repos"
+INSTALLED_DIR = LOCAL_DIR / "installed"
+
+CONFIG_TEMPLATE = """\
+# Agents Tool Configuration
+# Edit this file with your repos and preferences.
+
+repos:
+  # Example:
+  # - url: git@github.com:your-username/your-agents.git
+  #     user: your-username
+  #     branch: main
+  #
+  # - url: git@github.com:team/shared-agents.git
+  #     user: your-username
+  #     branch: develop
+
+defaults:
+  branch: main
+"""
+
+
+def init_config():
+    """Initialize configuration and directories."""
+    if CONFIG_FILE.exists():
+        click.echo(f"Config already exists: {CONFIG_FILE}")
+        click.echo("Edit it manually to add your repos.")
+        return
+
+    CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+    REPOS_DIR.mkdir(parents=True, exist_ok=True)
+    INSTALLED_DIR.mkdir(parents=True, exist_ok=True)
+
+    CONFIG_FILE.write_text(CONFIG_TEMPLATE)
+
+    click.echo("Agents tool initialized!")
+    click.echo(f"Config: {CONFIG_FILE}")
+    click.echo("Edit it to add your repos, then run: agents gou")
+
+
+def load_config():
+    """Load configuration from YAML file."""
+    if not CONFIG_FILE.exists():
+        raise FileNotFoundError(f"Config not found: {CONFIG_FILE}")
+
+    with open(CONFIG_FILE) as f:
+        return yaml.safe_load(f)

agents_tool/git.py

@@ -0,0 +1,95 @@
+"""Git operations for agents-tool."""
+
+import os
+from pathlib import Path
+
+import click
+from git import Repo
+
+from .config import load_config, REPOS_DIR, INSTALLED_DIR
+from .registry import sync_installed, update_registry
+
+
+def process_repos():
+    """Process all repos from config (clone or update)."""
+    config = load_config()
+    repos = config.get("repos", [])
+
+    if not repos:
+        click.echo("No repos configured.")
+        click.echo("Edit .agents/config.yaml to add repos.")
+        return
+
+    for repo_config in repos:
+        process_repo(repo_config)
+
+    # Sync and update registry after all repos are processed
+    click.echo()
+    click.echo("Syncing installed...")
+    sync_installed()
+
+    click.echo("Updating registry...")
+    update_registry()
+
+    click.echo()
+    click.echo("Done!")
+
+
+def process_repo(repo_config):
+    """Process a single repo (clone or update)."""
+    url = repo_config.get("url")
+    user = repo_config.get("user", "")
+    branch = repo_config.get("branch", "main")
+
+    if not url:
+        click.echo("Warning: Repo without URL, skipping.")
+        return
+
+    repo_name = extract_repo_name(url)
+    repo_path = REPOS_DIR / repo_name
+
+    if repo_path.exists():
+        update_repo(repo_path, branch)
+    else:
+        clone_repo(url, repo_path, branch)
+
+
+def extract_repo_name(url):
+    """Extract repo name from git URL."""
+    # Handle SSH URLs
+    if url.endswith(".git"):
+        url = url[:-4]
+    # Get last part after /
+    return url.split("/")[-1]
+
+
+def clone_repo(url, path, branch):
+    """Clone a repo with authentication."""
+    click.echo(f"Cloning: {url}")
+
+    try:
+        # Try cloning without auth first (public repos)
+        Repo.clone_from(url, str(path), branch=branch)
+        click.echo(f"  Cloned to: {path}")
+    except Exception as e:
+        if "Authentication" in str(e) or "public" in str(e).lower():
+            # Need auth - ask for token
+            token = click.prompt("Token", hide_input=True)
+            auth_url = url.replace("git@", f"https://{token}@")
+            Repo.clone_from(auth_url, str(path), branch=branch)
+            click.echo(f"  Cloned to: {path}")
+        else:
+            click.echo(f"  Error: {e}")
+
+
+def update_repo(path, branch):
+    """Pull updates for an existing repo."""
+    click.echo(f"Updating: {path.name}")
+
+    try:
+        repo = Repo(str(path))
+        origin = repo.remotes.origin
+        origin.pull(branch)
+        click.echo("  Updated")
+    except Exception as e:
+        click.echo(f"  Error: {e}")

agents_tool/registry.py

@@ -0,0 +1,229 @@
+"""Registry for installed agents, skills and harness."""
+
+import json
+import shutil
+from pathlib import Path
+
+import click
+import yaml
+
+from .config import REPOS_DIR, INSTALLED_DIR
+from .validator import validate_agent_yaml, validate_skill_md
+
+REGISTRY_FILE = INSTALLED_DIR / "registry.json"
+
+
+def update_registry():
+    """Update registry.json with current installed content."""
+    INSTALLED_DIR.mkdir(parents=True, exist_ok=True)
+
+    registry = {
+        "agents": find_agents(),
+        "skills": find_skills(),
+        "harness": find_harness(),
+    }
+
+    with open(REGISTRY_FILE, "w") as f:
+        json.dump(registry, f, indent=2)
+
+    return registry
+
+
+def load_registry():
+    """Load registry from file."""
+    if not REGISTRY_FILE.exists():
+        return update_registry()
+
+    with open(REGISTRY_FILE) as f:
+        return json.load(f)
+
+
+def sync_installed():
+    """Sync repos content to installed directory."""
+    INSTALLED_DIR.mkdir(parents=True, exist_ok=True)
+
+    # Clean installed directory
+    for item in INSTALLED_DIR.iterdir():
+        if item.name == "registry.json":
+            continue
+        if item.is_dir():
+            shutil.rmtree(item)
+        else:
+            item.unlink()
+
+    agents_dir = INSTALLED_DIR / "agents"
+    skills_dir = INSTALLED_DIR / "skills"
+    harness_dir = INSTALLED_DIR / "harness"
+
+    agents_dir.mkdir(exist_ok=True)
+    skills_dir.mkdir(exist_ok=True)
+    harness_dir.mkdir(exist_ok=True)
+
+    if not REPOS_DIR.exists():
+        return
+
+    for repo_dir in REPOS_DIR.iterdir():
+        if not repo_dir.is_dir():
+            continue
+
+        # Sync agents
+        repo_agents = repo_dir / "agents"
+        if repo_agents.exists():
+            for agent_dir in repo_agents.iterdir():
+                if not agent_dir.is_dir():
+                    continue
+
+                is_valid, errors, config = validate_agent_yaml(agent_dir)
+                if is_valid:
+                    dest = agents_dir / agent_dir.name
+                    if not dest.exists():
+                        shutil.copytree(agent_dir, dest)
+                else:
+                    click.echo(f"Warning: Invalid agent {agent_dir.name}: {errors}")
+
+        # Sync skills
+        repo_skills = repo_dir / "skills"
+        if repo_skills.exists():
+            for skill_dir in repo_skills.iterdir():
+                if not skill_dir.is_dir():
+                    continue
+
+                is_valid, errors, content = validate_skill_md(skill_dir)
+                if is_valid:
+                    dest = skills_dir / skill_dir.name
+                    if not dest.exists():
+                        shutil.copytree(skill_dir, dest)
+                else:
+                    click.echo(f"Warning: Invalid skill {skill_dir.name}: {errors}")
+
+        # Sync harness
+        repo_harness = repo_dir / "harness"
+        if repo_harness.exists():
+            for h_dir in repo_harness.iterdir():
+                if not h_dir.is_dir():
+                    continue
+
+                dest = harness_dir / h_dir.name
+                if not dest.exists():
+                    shutil.copytree(h_dir, dest)
+
+
+def list_installed():
+    """List all installed agents, skills and harness."""
+    registry = load_registry()
+
+    agents = registry.get("agents", [])
+    skills = registry.get("skills", [])
+    harness = registry.get("harness", [])
+
+    if not agents and not skills and not harness:
+        click.echo("No agents/skills/harness installed.")
+        click.echo("Run: agents gou")
+        return
+
+    if agents:
+        click.echo("Agents:")
+        for agent in agents:
+            version = agent.get('version', 'unknown')
+            source = agent.get('source', 'unknown')
+            click.echo(f"  - {agent['name']} v{version} ({source})")
+        click.echo()
+
+    if skills:
+        click.echo("Skills:")
+        for skill in skills:
+            source = skill.get('source', 'unknown')
+            click.echo(f"  - {skill['name']} ({source})")
+        click.echo()
+
+    if harness:
+        click.echo("Harness:")
+        for h in harness:
+            source = h.get('source', 'unknown')
+            click.echo(f"  - {h['name']} ({source})")
+
+
+def find_agents():
+    """Find all agents in repos."""
+    agents = []
+    if not REPOS_DIR.exists():
+        return agents
+
+    for repo_dir in REPOS_DIR.iterdir():
+        if not repo_dir.is_dir():
+            continue
+
+        agents_dir = repo_dir / "agents"
+        if not agents_dir.exists():
+            continue
+
+        for agent_dir in agents_dir.iterdir():
+            if not agent_dir.is_dir():
+                continue
+
+            config_file = agent_dir / "agent.yaml"
+            if config_file.exists():
+                with open(config_file) as f:
+                    config = yaml.safe_load(f) or {}
+
+                agents.append({
+                    "name": config.get("name", agent_dir.name),
+                    "version": config.get("version", "unknown"),
+                    "source": repo_dir.name,
+                })
+
+    return agents
+
+
+def find_skills():
+    """Find all skills in repos."""
+    skills = []
+    if not REPOS_DIR.exists():
+        return skills
+
+    for repo_dir in REPOS_DIR.iterdir():
+        if not repo_dir.is_dir():
+            continue
+
+        skills_dir = repo_dir / "skills"
+        if not skills_dir.exists():
+            continue
+
+        for skill_dir in skills_dir.iterdir():
+            if not skill_dir.is_dir():
+                continue
+
+            skill_file = skill_dir / "SKILL.md"
+            if skill_file.exists():
+                skills.append({
+                    "name": skill_dir.name,
+                    "source": repo_dir.name,
+                })
+
+    return skills
+
+
+def find_harness():
+    """Find all harness configurations in repos."""
+    harness = []
+    if not REPOS_DIR.exists():
+        return harness
+
+    for repo_dir in REPOS_DIR.iterdir():
+        if not repo_dir.is_dir():
+            continue
+
+        harness_dir = repo_dir / "harness"
+        if not harness_dir.exists():
+            continue
+
+        for h_dir in harness_dir.iterdir():
+            if not h_dir.is_dir():
+                continue
+
+            harness.append({
+                "name": h_dir.name,
+                "source": repo_dir.name,
+            })
+
+    return harness

agents_tool/validator.py

@@ -0,0 +1,86 @@
+"""Validation for agent/skill/harness definitions."""
+
+from pathlib import Path
+
+import yaml
+
+
+REQUIRED_AGENT_FIELDS = ["name"]
+VALID_TOOL_TYPES = ["read", "write", "edit", "bash", "grep", "glob"]
+
+
+def validate_agent_yaml(agent_dir):
+    """Validate agent.yaml in a directory.
+
+    Returns (is_valid, errors, config).
+    """
+    config_file = agent_dir / "agent.yaml"
+
+    if not config_file.exists():
+        return False, ["agent.yaml not found"], None
+
+    try:
+        with open(config_file) as f:
+            config = yaml.safe_load(f)
+    except yaml.YAMLError as e:
+        return False, [f"Invalid YAML: {e}"], None
+
+    if config is None:
+        return False, ["agent.yaml is empty"], None
+
+    errors = []
+
+    # Check required fields
+    for field in REQUIRED_AGENT_FIELDS:
+        if field not in config:
+            errors.append(f"Missing required field: {field}")
+
+    # Validate tools if present
+    if "tools" in config:
+        tools = config["tools"]
+        if not isinstance(tools, list):
+            errors.append("'tools' must be a list")
+        else:
+            for tool in tools:
+                if tool not in VALID_TOOL_TYPES:
+                    errors.append(f"Unknown tool type: {tool}")
+
+    # Validate name format
+    if "name" in config:
+        name = config["name"]
+        if not isinstance(name, str) or not name.strip():
+            errors.append("'name' must be a non-empty string")
+
+    return len(errors) == 0, errors, config
+
+
+def validate_skill_md(skill_dir):
+    """Validate SKILL.md in a directory.
+
+    Returns (is_valid, errors, content).
+    """
+    skill_file = skill_dir / "SKILL.md"
+
+    if not skill_file.exists():
+        return False, ["SKILL.md not found"], None
+
+    try:
+        content = skill_file.read_text()
+    except Exception as e:
+        return False, [f"Cannot read SKILL.md: {e}"], None
+
+    if not content.strip():
+        return False, ["SKILL.md is empty"], None
+
+    # Check for frontmatter
+    if content.startswith("---"):
+        try:
+            parts = content.split("---", 2)
+            if len(parts) >= 3:
+                frontmatter = yaml.safe_load(parts[1])
+                if frontmatter and "name" not in frontmatter:
+                    return False, ["Frontmatter missing 'name' field"], content
+        except yaml.YAMLError:
+            return False, ["Invalid YAML in frontmatter"], content
+
+    return True, [], content

agents_tool-0.1.0.dist-info/METADATA

@@ -0,0 +1,64 @@
+Metadata-Version: 2.5
+Name: agents-tool
+Version: 0.1.0
+Summary: CLI tool for managing AI agents, skills and harness
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: click>=8.1.0
+Requires-Dist: gitpython>=3.1.0
+Requires-Dist: pyyaml>=6.0
+Description-Content-Type: text/markdown
+
+# Agents Tool
+
+CLI tool for managing AI agents, skills and harness.
+
+## Installation
+
+```bash
+pip install agents-tool
+```
+
+## Usage
+
+```bash
+# Initialize configuration
+agents init
+
+# Edit config to add your repos
+vim ~/.config/agents/config.yaml
+
+# Import/update all agents
+agents gou
+
+# List installed agents/skills/harness
+agents list
+```
+
+## Configuration
+
+Edit `~/.config/agents/config.yaml`:
+
+```yaml
+repos:
+  - url: git@github.com:your-username/your-agents.git
+    user: your-username
+    branch: main
+```
+
+## Agent Repo Structure
+
+```
+your-agents/
+├── agents/
+│   └── reviewer/
+│       ├── agent.yaml
+│       └── prompt.md
+├── skills/
+│   └── code-review/
+│       └── SKILL.md
+└── harness/
+    └── opencode/
+        └── config.json
+```

agents_tool-0.1.0.dist-info/RECORD

@@ -0,0 +1,11 @@
+agents_tool/__init__.py,sha256=a6BznFb0FAS2EI_TXOqZLiuRdBRtdO1Jc2HdmFDHiQE,91
+agents_tool/cli.py,sha256=x8bTS-QhT5tAMKjL8ptHH8LF8bGc7rzPfdps9gpRGl0,641
+agents_tool/config.py,sha256=M0rTii7TusHlrK7Glx5i_IhCnA0Kt-cQ5VwWa99DsJU,1507
+agents_tool/git.py,sha256=mo7RBHaGes4BjrnY93FlQuHHj26JI2vNvdBYOFuxZzU,2532
+agents_tool/registry.py,sha256=mqAUxqDCuVjtXw9O4gNkLCZkKWe2tTSJa6_J_sHOjyk,6311
+agents_tool/validator.py,sha256=x48PHYrtQgmU3zD0OenNU9uWHuk9uTwW044gpJr7zdw,2416
+agents_tool-0.1.0.dist-info/METADATA,sha256=QMxjtVwidmVL4NBaRFxEJienW7T0AsRMulrqYv7yePU,1127
+agents_tool-0.1.0.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+agents_tool-0.1.0.dist-info/entry_points.txt,sha256=pGdW_2B-utlHR6EtcBglUVGHd_QHnrMjz6DkR2tJ3UQ,48
+agents_tool-0.1.0.dist-info/licenses/LICENSE,sha256=ESYyLizI0WWtxMeS7rGVcX3ivMezm-HOd5WdeOh-9oU,1056
+agents_tool-0.1.0.dist-info/RECORD,,

agents_tool-0.1.0.dist-info/WHEEL

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

agents_tool-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+agents = agents_tool.cli:main

agents_tool-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.