agents-tool 0.1.0__tar.gz

agents_tool-0.1.0/.gitignore

@@ -0,0 +1,40 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Local agents config
+.agents/

agents_tool-0.1.0/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.

agents_tool-0.1.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,52 @@
+# 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/design.md

@@ -0,0 +1,132 @@
+# Agents Tool - Design
+
+## Arquitetura
+
+```
++-----------------------------------------------------------+
+|                    CLI (click)                             |
++-----------------------------------------------------------+
+|                                                           |
+|  agents init        Cria config.yaml (statico)            |
+|  agents gou         Get or Update (importa/atualiza)      |
+|  agents list        Mostra agents/skills instalados       |
+|                                                           |
++-----------------------------------------------------------+
+                           |
+                           v
++-----------------------------------------------------------+
+|                    Core                                    |
++-----------------------------------------------------------+
+|                                                           |
+|  ConfigManager    Le/escrive config.yaml                  |
+|  GitManager       Operacoes git (clone, pull, auth)       |
+|  Registry         Indexa agents/skills disponiveis        |
+|  Runner           Executa agentes                         |
+|                                                           |
++-----------------------------------------------------------+
+                           |
+                           v
++-----------------------------------------------------------+
+|                    Storage                                 |
++-----------------------------------------------------------+
+|                                                           |
+|  ~/.config/agents/config.yaml    Configuracao global      |
+|  ~/.local/share/agents/                                  |
+|    repos/                   Clones dos repos              |
+|    installed/               Agents/skills disponiveis     |
+|                                                           |
++-----------------------------------------------------------+
+```
+
+## Estrutura do Repo Padronizado
+
+```
+meu-repo-agents/
+├── agents/
+│   ├── reviewer/
+│   │   ├── agent.yaml
+│   │   └── prompt.md
+│   └── coder/
+│       ├── agent.yaml
+│       └── prompt.md
+├── skills/
+│   ├── code-review/
+│   │   └── SKILL.md
+│   └── refactor/
+│       └── SKILL.md
+└── harness/
+    ├── opencode/
+    │   └── config.json
+    └── cursor/
+        └── rules.md
+```
+
+## agent.yaml (exemplo)
+
+```yaml
+name: reviewer
+version: "1.0"
+description: "Code reviewer agentic"
+tools:
+  - read
+  - grep
+  - bash (readonly)
+dependencies: []
+```
+
+## Config (~/.config/agents/config.yaml)
+
+```yaml
+repos:
+  - url: git@github.com:meu-usuario/agents.git
+    user: meu-usuario
+    branch: main
+    last_updated: null
+  - url: git@github.com:equipe/shared.git
+    user: meu-usuario
+    branch: develop
+    last_updated: null
+
+defaults:
+  branch: main
+```
+
+## Autenticacao
+
+Duas opcoes:
+
+### Opcao 1: Token via terminal (recomendado)
+```
+$ agents update
+Repo: meu-usuario/agents
+Token: ********
+Pulling...
+Done.
+```
+
+### Opcao 2: SSH key
+```
+$ agents update
+Repo: meu-usuario/agents
+Using SSH key...
+Pulling...
+Done.
+```
+
+## Sincronizacao
+
+Para cada repo, o `update` faz:
+1. `git fetch` (com autenticacao)
+2. `git pull` (atualiza)
+3. Indexa agents/skills novos
+4. Copia/gera links pra `installed/`
+
+## Decisoes Tecnicas
+
+| Decisao | Opcao | Justificativa |
+|---------|-------|---------------|
+| Linguagem | Python | Facil instalacao, pip/pipx |
+| CLI | click | CLI framework popular e simples |
+| Git | gitpython | Wrapper nativo do git |
+| Storage | Local filesystem | Sem daemon necessario |
+| Auth | Token interativo | Seguro, sem persistir senha |

agents_tool-0.1.0/proposal.md

@@ -0,0 +1,46 @@
+# Agents Tool - Proposal
+
+## O que e
+
+Uma CLI para gerenciar agents, skills e harness de forma global. As pessoas criam seus repos no GitHub com uma estrutura padronizada e usam essa ferramenta pra instalar, atualizar e compartilhar.
+
+## Problema
+
+Hoje, quem usa agentes de IA (opencode, cursor, etc) tem seus agents/skills espalhados:
+- Copy-paste entre projetos
+- Sem versionamento
+- Dificil de compartilhar com equipe
+- Cada ferramenta tem seu proprio formato
+
+## Solucao
+
+Um gerenciador de dotfiles especifico para agentes:
+- Estrutura padronizada (agents/, skills/, harness/)
+- Git como backend de armazenamento
+- Config global (~/.config/agents/)
+- Comando unico pra atualizar tudo
+
+## Publico-alvo
+
+- Desenvolvedores que usam agentes de IA
+- Equipes que querem compartilhar configs
+- Quem quer manter seus agents versionados
+
+## Exemplo de uso
+
+```bash
+# Primeira vez
+pip install agents-tool
+agents init
+
+# Editar config
+vim ~/.config/agents/config.yaml
+
+# Importar/atualizar tudo
+agents gou
+
+# Listar o que esta instalado
+agents list
+```
+
+A ferramenta so gerencia a instalacao. A execucao dos agents fica por conta de cada ferramenta (opencode, cursor, etc).

agents_tool-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "agents-tool"
+version = "0.1.0"
+description = "CLI tool for managing AI agents, skills and harness"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+dependencies = [
+    "click>=8.1.0",
+    "gitpython>=3.1.0",
+    "pyyaml>=6.0",
+]
+
+[project.scripts]
+agents = "agents_tool.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/agents_tool"]

agents_tool-0.1.0/specs/commands.md

@@ -0,0 +1,32 @@
+# Agents Tool - Specs
+
+## Comandos
+
+### agents init
+
+- Cria `~/.config/agents/config.yaml` com template vazio
+- Mostra mensagem explicando pra editar o arquivo
+- Nao clone nada (so cria o config)
+
+### agents gou (get or update)
+
+- Le `~/.config/agents/config.yaml`
+- Para cada repo:
+  - Se nao existe localmente -> clone (get)
+  - Se ja existe -> pull (update)
+  - Pede token/senha via terminal (se necessario)
+  - Indexa agents/skills/harness encontrados
+  - Copia pra `installed/`
+- Mostra resumo do que foi instalado/atualizado
+
+### agents list
+
+- Lista agents instalados
+- Lista skills instalados
+- Lista harness instalados
+- Mostra versao e repo de origem
+
+## Nao faz parte
+
+- Execucao de agentes (ferramenta do usuario decide)
+- Integracao com LLM (cada ferramenta tem seu jeito)

agents_tool-0.1.0/specs/python-structure.md

@@ -0,0 +1,24 @@
+# Agents Tool - Python Project Structure
+
+```
+agents-tool/
+├── pyproject.toml
+├── README.md
+├── src/
+│   └── agents_tool/
+│       ├── __init__.py
+│       ├── cli.py          # Click commands
+│       ├── config.py       # ConfigManager
+│       ├── git.py          # GitManager
+│       ├── registry.py     # Registry
+│       └── runner.py       # Runner
+└── tests/
+    └── ...
+```
+
+## Dependencias
+
+- click - CLI framework
+- gitpython - Git operations
+- pyyaml - Config files
+- rich - Terminal output (opcional)

agents_tool-0.1.0/src/agents_tool/__init__.py

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

agents_tool-0.1.0/src/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-0.1.0/src/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-0.1.0/src/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}")