agentforge-cli 0.1.0__tar.gz

agentforge_cli-0.1.0/PKG-INFO

@@ -0,0 +1,53 @@
+Metadata-Version: 2.4
+Name: agentforge-cli
+Version: 0.1.0
+Summary: Registry and trust layer for AI agent skills
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: typer>=0.9.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: pyyaml>=6.0
+
+# agentforge (CLI: forge)
+
+Registry and trust layer for AI agent skills. This package provides the **forge** command so you can create, inspect, publish, and install skills from the terminal.
+
+## Install
+
+```bash
+pip install agentforge-cli
+```
+
+## Use
+
+From any directory:
+
+```bash
+forge init              # scaffold a skill (skill.yaml + example code)
+forge inspect           # show permissions and risk for the skill here
+forge publish           # publish to the registry
+forge search            # list skills
+forge install <slug>    # record an install
+```
+
+**Registry URL (what `-r` is for)**  
+The **registry** is the backend API that stores and serves skills. When you deploy the AgentForge backend (e.g. on Render or Railway), you get a URL like `https://agentforge-api.onrender.com`. That URL is your **registry URL**.
+
+- **`forge publish`** sends your skill to that API so it appears on the website and in `forge search`.
+- **`forge search`** and **`forge install`** read from that same API.
+
+If you don’t pass `-r`, the CLI defaults to `http://localhost:8000` (your own API running on your machine). For the **public** registry, pass its URL:
+
+```bash
+# Example: your backend is at https://agentforge-api.onrender.com
+forge publish -r https://agentforge-api.onrender.com
+forge search -r https://agentforge-api.onrender.com
+forge install send-email -r https://agentforge-api.onrender.com
+```
+
+So `https://your-api.example.com` in the docs is a **placeholder** for whatever your real backend URL is (e.g. from Render or Railway).
+
+## Links
+
+- [AgentForge](https://github.com/vince13/AgentForge) — repo and docs

agentforge_cli-0.1.0/README.md

@@ -0,0 +1,42 @@
+# agentforge (CLI: forge)
+
+Registry and trust layer for AI agent skills. This package provides the **forge** command so you can create, inspect, publish, and install skills from the terminal.
+
+## Install
+
+```bash
+pip install agentforge-cli
+```
+
+## Use
+
+From any directory:
+
+```bash
+forge init              # scaffold a skill (skill.yaml + example code)
+forge inspect           # show permissions and risk for the skill here
+forge publish           # publish to the registry
+forge search            # list skills
+forge install <slug>    # record an install
+```
+
+**Registry URL (what `-r` is for)**  
+The **registry** is the backend API that stores and serves skills. When you deploy the AgentForge backend (e.g. on Render or Railway), you get a URL like `https://agentforge-api.onrender.com`. That URL is your **registry URL**.
+
+- **`forge publish`** sends your skill to that API so it appears on the website and in `forge search`.
+- **`forge search`** and **`forge install`** read from that same API.
+
+If you don’t pass `-r`, the CLI defaults to `http://localhost:8000` (your own API running on your machine). For the **public** registry, pass its URL:
+
+```bash
+# Example: your backend is at https://agentforge-api.onrender.com
+forge publish -r https://agentforge-api.onrender.com
+forge search -r https://agentforge-api.onrender.com
+forge install send-email -r https://agentforge-api.onrender.com
+```
+
+So `https://your-api.example.com` in the docs is a **placeholder** for whatever your real backend URL is (e.g. from Render or Railway).
+
+## Links
+
+- [AgentForge](https://github.com/vince13/AgentForge) — repo and docs

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

@@ -0,0 +1,53 @@
+Metadata-Version: 2.4
+Name: agentforge-cli
+Version: 0.1.0
+Summary: Registry and trust layer for AI agent skills
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: typer>=0.9.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: pyyaml>=6.0
+
+# agentforge (CLI: forge)
+
+Registry and trust layer for AI agent skills. This package provides the **forge** command so you can create, inspect, publish, and install skills from the terminal.
+
+## Install
+
+```bash
+pip install agentforge-cli
+```
+
+## Use
+
+From any directory:
+
+```bash
+forge init              # scaffold a skill (skill.yaml + example code)
+forge inspect           # show permissions and risk for the skill here
+forge publish           # publish to the registry
+forge search            # list skills
+forge install <slug>    # record an install
+```
+
+**Registry URL (what `-r` is for)**  
+The **registry** is the backend API that stores and serves skills. When you deploy the AgentForge backend (e.g. on Render or Railway), you get a URL like `https://agentforge-api.onrender.com`. That URL is your **registry URL**.
+
+- **`forge publish`** sends your skill to that API so it appears on the website and in `forge search`.
+- **`forge search`** and **`forge install`** read from that same API.
+
+If you don’t pass `-r`, the CLI defaults to `http://localhost:8000` (your own API running on your machine). For the **public** registry, pass its URL:
+
+```bash
+# Example: your backend is at https://agentforge-api.onrender.com
+forge publish -r https://agentforge-api.onrender.com
+forge search -r https://agentforge-api.onrender.com
+forge install send-email -r https://agentforge-api.onrender.com
+```
+
+So `https://your-api.example.com` in the docs is a **placeholder** for whatever your real backend URL is (e.g. from Render or Railway).
+
+## Links
+
+- [AgentForge](https://github.com/vince13/AgentForge) — repo and docs

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

@@ -0,0 +1,17 @@
+README.md
+pyproject.toml
+agentforge_cli.egg-info/PKG-INFO
+agentforge_cli.egg-info/SOURCES.txt
+agentforge_cli.egg-info/dependency_links.txt
+agentforge_cli.egg-info/entry_points.txt
+agentforge_cli.egg-info/requires.txt
+agentforge_cli.egg-info/top_level.txt
+forge/__init__.py
+forge/__main__.py
+forge/cli.py
+forge/commands/__init__.py
+forge/commands/init_cmd.py
+forge/commands/inspect_cmd.py
+forge/commands/install_cmd.py
+forge/commands/publish_cmd.py
+forge/commands/search_cmd.py

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,2 @@
+[console_scripts]
+forge = forge.cli:app

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

@@ -0,0 +1,4 @@
+typer>=0.9.0
+rich>=13.0.0
+httpx>=0.25.0
+pyyaml>=6.0

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

@@ -0,0 +1 @@
+forge

agentforge_cli-0.1.0/forge/__init__.py

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

agentforge_cli-0.1.0/forge/__main__.py

@@ -0,0 +1,5 @@
+"""Run the CLI via python -m forge."""
+from forge.cli import app
+
+if __name__ == "__main__":
+    app()

agentforge_cli-0.1.0/forge/cli.py

@@ -0,0 +1,58 @@
+import typer
+from rich.console import Console
+
+from forge.commands import init_cmd, inspect_cmd, publish_cmd, search_cmd, install_cmd
+
+app = typer.Typer(
+    name="forge",
+    help="Registry and trust layer for AI agent skills.",
+    add_completion=False,
+)
+console = Console()
+
+
+@app.command()
+def init(
+    path: str = typer.Argument(".", help="Directory to scaffold (default: current)"),
+):
+    """Scaffold a skill.yaml and example code."""
+    init_cmd.run(path, console=console)
+
+
+@app.command()
+def inspect(
+    path: str = typer.Argument(".", help="Directory containing skill.yaml"),
+):
+    """Show permissions and risk score for the skill in this directory."""
+    inspect_cmd.run(path, console=console)
+
+
+@app.command()
+def publish(
+    path: str = typer.Argument(".", help="Directory containing skill.yaml"),
+    registry: str = typer.Option("http://localhost:8000", "--registry", "-r", help="Registry API URL"),
+):
+    """Publish the skill to the registry."""
+    publish_cmd.run(path, registry=registry, console=console)
+
+
+@app.command()
+def search(
+    query: str = typer.Argument("", help="Search query (optional)"),
+    registry: str = typer.Option("http://localhost:8000", "--registry", "-r", help="Registry API URL"),
+):
+    """List or search skills in the registry."""
+    search_cmd.run(query, registry=registry, console=console)
+
+
+@app.command()
+def install(
+    slug: str = typer.Argument(..., help="Skill slug to install (e.g. send-email)"),
+    registry: str = typer.Option("http://localhost:8000", "--registry", "-r", help="Registry API URL"),
+):
+    """Record an install for a skill (increments install count)."""
+    install_cmd.run(slug, registry=registry, console=console)
+
+
+if __name__ == "__main__":
+    app()

agentforge_cli-0.1.0/forge/commands/__init__.py

@@ -0,0 +1 @@
+from . import init_cmd, inspect_cmd, publish_cmd, search_cmd, install_cmd

agentforge_cli-0.1.0/forge/commands/init_cmd.py

@@ -0,0 +1,44 @@
+import os
+from pathlib import Path
+
+from rich.console import Console
+from rich.panel import Panel
+
+EXAMPLE_MANIFEST = """name: send_email
+version: 0.1.0
+description: Send transactional emails
+author: vincent
+entrypoint: send_email.py
+
+permissions:
+  - network:outbound
+  - secrets:read
+  - filesystem:write:/tmp
+"""
+
+EXAMPLE_ENTRYPOINT = '''"""Example skill entrypoint."""
+# Your skill logic here.
+def run():
+    print("Hello from send_email skill")
+'''
+
+def run(path: str, console: Console) -> None:
+    base = Path(path).resolve()
+    base.mkdir(parents=True, exist_ok=True)
+    manifest_path = base / "skill.yaml"
+    if manifest_path.exists():
+        console.print("[yellow]skill.yaml already exists, skipping.[/yellow]")
+    else:
+        manifest_path.write_text(EXAMPLE_MANIFEST, encoding="utf-8")
+        console.print(f"[green]Created {manifest_path}[/green]")
+    entrypoint_name = "send_email.py"
+    entrypath = base / entrypoint_name
+    if not entrypath.exists():
+        entrypath.write_text(EXAMPLE_ENTRYPOINT, encoding="utf-8")
+        console.print(f"[green]Created {entrypath}[/green]")
+    console.print(Panel(
+        "Run [bold]forge inspect[/bold] to see permissions and risk.\n"
+        "Run [bold]forge publish[/bold] to publish to the registry.",
+        title="Next steps",
+        border_style="blue",
+    ))

agentforge_cli-0.1.0/forge/commands/inspect_cmd.py

@@ -0,0 +1,65 @@
+from pathlib import Path
+import yaml
+
+from rich.console import Console
+from rich.table import Table
+from rich.panel import Panel
+
+# Inline risk logic (mirrors backend)
+PERMISSION_RISK = {
+    "network": "MEDIUM", "network:outbound": "MEDIUM", "network:inbound": "MEDIUM",
+    "filesystem": "MEDIUM", "filesystem:read": "LOW", "filesystem:write": "MEDIUM",
+    "secrets": "HIGH", "secrets:read": "HIGH", "secrets:write": "HIGH",
+    "payments": "HIGH", "payments:read": "HIGH", "payments:write": "HIGH",
+}
+RISK_ORDER = {"LOW": 0, "MEDIUM": 1, "HIGH": 2}
+
+
+def permission_to_risk(permission: str) -> str:
+    perm = permission.strip().lower()
+    if perm in PERMISSION_RISK:
+        return PERMISSION_RISK[perm]
+    if perm.startswith("network"):
+        return "MEDIUM"
+    if perm.startswith("filesystem"):
+        return "MEDIUM"
+    if perm.startswith("secrets") or perm.startswith("payments"):
+        return "HIGH"
+    return "LOW"
+
+
+def run(path: str, console: Console) -> None:
+    base = Path(path).resolve()
+    manifest_path = base / "skill.yaml"
+    if not manifest_path.exists():
+        console.print("[red]skill.yaml not found. Run 'forge init' first.[/red]")
+        raise SystemExit(1)
+    data = yaml.safe_load(manifest_path.read_text(encoding="utf-8")) or {}
+    perms = data.get("permissions") or []
+    if isinstance(perms, str):
+        perms = [p.strip() for p in perms.split(",") if p.strip()]
+    explained = []
+    max_level = "LOW"
+    for p in perms:
+        r = permission_to_risk(p)
+        explained.append((p, r))
+        if RISK_ORDER.get(r, 0) > RISK_ORDER.get(max_level, 0):
+            max_level = r
+    name = data.get("name", "unnamed")
+    version = data.get("version", "0.1.0")
+    console.print(Panel(f"[bold]{name}[/bold] v{version}", title="Skill", border_style="blue"))
+    console.print(f"  [dim]Description:[/dim] {data.get('description') or '(none)'}")
+    console.print(f"  [dim]Author:[/dim] {data.get('author') or '(none)'}")
+    console.print(f"  [dim]Entrypoint:[/dim] {data.get('entrypoint') or '(none)'}")
+    risk_style = {"LOW": "green", "MEDIUM": "yellow", "HIGH": "red"}.get(max_level, "white")
+    console.print(f"  [dim]Overall risk:[/dim] [{risk_style}]{max_level}[/{risk_style}]")
+    if explained:
+        table = Table(title="Permissions")
+        table.add_column("Permission", style="cyan")
+        table.add_column("Risk", style="magenta")
+        for p, r in explained:
+            rs = {"LOW": "green", "MEDIUM": "yellow", "HIGH": "red"}.get(r, "white")
+            table.add_row(p, f"[{rs}]{r}[/{rs}]")
+        console.print(table)
+    else:
+        console.print("[dim]No permissions declared.[/dim]")

agentforge_cli-0.1.0/forge/commands/install_cmd.py

@@ -0,0 +1,28 @@
+import httpx
+
+from rich.console import Console
+from rich.panel import Panel
+
+
+def run(slug: str, registry: str, console: Console) -> None:
+    url = f"{registry.rstrip('/')}/skills/{slug}/install"
+    try:
+        with httpx.Client(timeout=10.0) as client:
+            r = client.post(url)
+            r.raise_for_status()
+            out = r.json()
+    except httpx.ConnectError:
+        console.print(f"[red]Could not reach registry at {registry}. Is the API running?[/red]")
+        raise SystemExit(1)
+    except httpx.HTTPStatusError as e:
+        if e.response.status_code == 404:
+            console.print(f"[red]Skill '{slug}' not found.[/red]")
+        else:
+            console.print(f"[red]Install failed: {e.response.status_code}[/red]")
+        raise SystemExit(1)
+    console.print(Panel(
+        f"Installed [bold]{out.get('name')}[/bold] ([cyan]{out.get('slug')}[/cyan])\n"
+        f"Install count: {out.get('installs', 0)}",
+        title="Installed",
+        border_style="green",
+    ))

agentforge_cli-0.1.0/forge/commands/publish_cmd.py

@@ -0,0 +1,47 @@
+from pathlib import Path
+import yaml
+import httpx
+
+from rich.console import Console
+from rich.panel import Panel
+
+
+def run(path: str, registry: str, console: Console) -> None:
+    base = Path(path).resolve()
+    manifest_path = base / "skill.yaml"
+    if not manifest_path.exists():
+        console.print("[red]skill.yaml not found. Run 'forge init' first.[/red]")
+        raise SystemExit(1)
+    data = yaml.safe_load(manifest_path.read_text(encoding="utf-8")) or {}
+    perms = data.get("permissions") or []
+    if isinstance(perms, str):
+        perms = [p.strip() for p in perms.split(",") if p.strip()]
+    payload = {
+        "name": data.get("name", "unnamed"),
+        "version": data.get("version", "0.1.0"),
+        "description": data.get("description"),
+        "author": data.get("author"),
+        "entrypoint": data.get("entrypoint"),
+        "permissions": perms,
+        "manifest": data,
+    }
+    url = f"{registry.rstrip('/')}/skills/publish"
+    try:
+        with httpx.Client(timeout=10.0) as client:
+            r = client.post(url, json=payload)
+            r.raise_for_status()
+            out = r.json()
+    except httpx.ConnectError:
+        console.print(f"[red]Could not reach registry at {registry}. Is the API running?[/red]")
+        raise SystemExit(1)
+    except httpx.HTTPStatusError as e:
+        console.print(f"[red]Publish failed: {e.response.status_code} {e.response.text}[/red]")
+        raise SystemExit(1)
+    slug = out.get("slug", "?")
+    console.print(Panel(
+        f"Published [bold]{out.get('name')}[/bold] as [cyan]{slug}[/cyan]\n"
+        f"Risk: [bold]{out.get('risk_score', 'LOW')}[/bold]\n"
+        f"View: {registry.rstrip('/')}/skills/{slug}",
+        title="Published",
+        border_style="green",
+    ))

agentforge_cli-0.1.0/forge/commands/search_cmd.py

@@ -0,0 +1,38 @@
+import httpx
+
+from rich.console import Console
+from rich.table import Table
+
+
+def run(query: str, registry: str, console: Console) -> None:
+    url = f"{registry.rstrip('/')}/skills"
+    try:
+        with httpx.Client(timeout=10.0) as client:
+            r = client.get(url)
+            r.raise_for_status()
+            skills = r.json()
+    except httpx.ConnectError:
+        console.print(f"[red]Could not reach registry at {registry}. Is the API running?[/red]")
+        raise SystemExit(1)
+    except httpx.HTTPStatusError as e:
+        console.print(f"[red]Search failed: {e.response.status_code}[/red]")
+        raise SystemExit(1)
+    if query:
+        q = query.lower()
+        skills = [s for s in skills if q in (s.get("name") or "").lower() or q in (s.get("slug") or "").lower() or q in (s.get("description") or "").lower()]
+    if not skills:
+        console.print("[dim]No skills found.[/dim]")
+        return
+    table = Table(title="Skills")
+    table.add_column("Slug", style="cyan")
+    table.add_column("Name", style="green")
+    table.add_column("Risk", style="yellow")
+    table.add_column("Installs")
+    for s in skills:
+        table.add_row(
+            s.get("slug", "?"),
+            s.get("name", "?"),
+            s.get("risk_score", "LOW"),
+            str(s.get("installs", 0)),
+        )
+    console.print(table)

agentforge_cli-0.1.0/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "agentforge-cli"
+version = "0.1.0"
+description = "Registry and trust layer for AI agent skills"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "typer>=0.9.0",
+    "rich>=13.0.0",
+    "httpx>=0.25.0",
+    "pyyaml>=6.0",
+]
+
+[project.scripts]
+forge = "forge.cli:app"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["forge*"]

agentforge_cli-0.1.0/setup.cfg

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