lockthard-cli 0.1.3__tar.gz → 0.2.0__tar.gz

{lockthard_cli-0.1.3 → lockthard_cli-0.2.0}/PKG-INFO

@@ -1,92 +1,92 @@
-Metadata-Version: 2.4
-Name: lockthard-cli
-Version: 0.1.3
-Summary: Super efficient CLI for LOCKTHARD AI tools directory and agents
-Author-email: Lockthard Team <info@lockthard.es>
-License: MIT
-Project-URL: Homepage, https://lockthard.es
-Keywords: cli,ai-tools,agents,mcp,lockthard
-Classifier: Development Status :: 4 - Beta
-Classifier: Environment :: Console
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Utilities
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-Requires-Dist: click>=8.1.0
-Requires-Dist: requests>=2.28.0
-Requires-Dist: rich>=13.0.0
-
-# LOCKTHARD CLI (`lockthard`)
-
-A super efficient, scriptable command-line interface and AI agent client for **LOCKTHARD** (https://lockthard.es).
-
-Allows both human developers and autonomous AI agents (Claude Code, Antigravity, Aider, Cursor, etc.) to query, search, and inspect 61+ tablets and 1200+ AI tools with minimum token usage and zero prompt overhead.
-
-## Installation
-
-```bash
-pip install lockthard-cli
-```
-
-Or run without installing:
-
-```bash
-pipx run lockthard-cli --help
-```
-
-## Quick Start
-
-### 1. Authentication
-Get your API key from [lockthard.es](https://lockthard.es).
-
-- **For AI Agents & CI/CD:**
-  ```bash
-  export LOCKTHARD_API_KEY="lk_your_token_here"
-  ```
-- **Interactive Browser Login (Humans):**
-  ```bash
-  lockthard login
-  ```
-- **Manual Login:**
-  ```bash
-  lockthard login --token "lk_your_token_here"
-  ```
-
-### 2. Commands
-
-```bash
-# Ping service
-lockthard ping
-
-# Search tools (returns concise ASCII table)
-lockthard search "ocr"
-
-# Search tools in raw JSON (for agents / jq)
-lockthard search "ocr" --json
-
-# List all tablets
-lockthard tablets list
-
-# Inspect a specific tablet
-lockthard tablets get ocr
-
-# Inspect tool details
-lockthard tools get "Chandra OCR"
-
-# Display CLI agent guide
-lockthard guide
-```
-
-## Options
-
-- `--json` / `-j`: Output raw JSON without Rich styling.
-- `--url` / `-u`: Override base server URL (default: `https://lockthard.es`).
-- `--token` / `-t`: Override API token.
-
-## License
-
-MIT License
+Metadata-Version: 2.4
+Name: lockthard-cli
+Version: 0.2.0
+Summary: CLI and AI agent client for LOCKTHARD — query 2100+ curated AI tools across 86+ tablets
+Author-email: Lockthard Team <info@lockthard.es>
+License: MIT
+Project-URL: Homepage, https://lockthard.es
+Keywords: cli,ai-tools,agents,mcp,lockthard
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.1.0
+Requires-Dist: requests>=2.28.0
+Requires-Dist: rich>=13.0.0
+
+# LOCKTHARD CLI (`lockthard`)
+
+A super efficient, scriptable command-line interface and AI agent client for **LOCKTHARD** (https://lockthard.es).
+
+Allows both human developers and autonomous AI agents (Claude Code, Antigravity, Aider, Cursor, etc.) to query, search, and inspect 61+ tablets and 1200+ AI tools with minimum token usage and zero prompt overhead.
+
+## Installation
+
+```bash
+pip install lockthard-cli
+```
+
+Or run without installing:
+
+```bash
+pipx run lockthard-cli --help
+```
+
+## Quick Start
+
+### 1. Authentication
+Get your API key from [lockthard.es](https://lockthard.es).
+
+- **For AI Agents & CI/CD:**
+  ```bash
+  export LOCKTHARD_API_KEY="lk_your_token_here"
+  ```
+- **Interactive Browser Login (Humans):**
+  ```bash
+  lockthard login
+  ```
+- **Manual Login:**
+  ```bash
+  lockthard login --token "lk_your_token_here"
+  ```
+
+### 2. Commands
+
+```bash
+# Ping service
+lockthard ping
+
+# Search tools (returns concise ASCII table)
+lockthard search "ocr"
+
+# Search tools in raw JSON (for agents / jq)
+lockthard search "ocr" --json
+
+# List all tablets
+lockthard tablets list
+
+# Inspect a specific tablet
+lockthard tablets get ocr
+
+# Inspect tool details
+lockthard tools get "Chandra OCR"
+
+# Display CLI agent guide
+lockthard guide
+```
+
+## Options
+
+- `--json` / `-j`: Output raw JSON without Rich styling.
+- `--url` / `-u`: Override base server URL (default: `https://lockthard.es`).
+- `--token` / `-t`: Override API token.
+
+## License
+
+MIT License

{lockthard_cli-0.1.3 → lockthard_cli-0.2.0}/lockthard_cli/__init__.py

@@ -2,4 +2,4 @@
 LOCKTHARD CLI - Command Line Interface and Agent Client for LOCKTHARD.
 """
 
-__version__ = "0.1.3"
+__version__ = "0.2.0"

{lockthard_cli-0.1.3 → lockthard_cli-0.2.0}/lockthard_cli/cli.py

@@ -15,7 +15,6 @@ from .formatters import (
     print_tool_details,
     print_cli_tools,
     print_agent_guide,
-    print_agent_skill
 )
 
 
@@ -25,6 +24,11 @@ def _handle_error(err: Exception):
     sys.exit(1)
 
 
+def _get_as_json(ctx: click.Context, local_flag: bool) -> bool:
+    """Merge global --json with local subcommand --json flag."""
+    return ctx.obj.get("as_json", False) or local_flag
+
+
 @click.group(invoke_without_command=False)
 @click.option("--url", "-u", default=None, help="Base URL del servidor LOCKTHARD (default: https://lockthard.es).")
 @click.option("--token", "-t", default=None, help="API Key / Token de autenticación (lk_...).")
@@ -44,13 +48,16 @@ def cli(ctx: click.Context, url: Optional[str], token: Optional[str], as_json: b
 
 
 @cli.command()
+@click.option("--json", "-j", "as_json_local", is_flag=True, default=False,
+              help="Salida en JSON bruto (ideal para scripts y agentes).")
 @click.pass_context
-def ping(ctx: click.Context):
+def ping(ctx: click.Context, as_json_local: bool):
     """Verifica la conectividad con el servidor de LOCKTHARD y el estado del token."""
     client: LockthardClient = ctx.obj["client"]
+    as_json = _get_as_json(ctx, as_json_local)
     try:
         res = client.ping()
-        print_ping_result(res, as_json=ctx.obj["as_json"])
+        print_ping_result(res, as_json=as_json)
     except LockthardError as e:
         _handle_error(e)
 
@@ -98,16 +105,19 @@ def logout():
 
 
 @cli.command()
+@click.option("--json", "-j", "as_json_local", is_flag=True, default=False,
+              help="Salida en JSON bruto (ideal para scripts y agentes).")
 @click.argument("query")
 @click.option("--tablet", "-t", help="Filtrar por ID de tablet específica.")
 @click.option("--limit", "-l", default=20, type=int, help="Límite de resultados (default: 20).")
 @click.pass_context
-def search(ctx: click.Context, query: str, tablet: Optional[str], limit: int):
+def search(ctx: click.Context, as_json_local: bool, query: str, tablet: Optional[str], limit: int):
     """Busca herramientas por palabra clave en LOCKTHARD."""
     client: LockthardClient = ctx.obj["client"]
+    as_json = _get_as_json(ctx, as_json_local)
     try:
         results = client.search_tools(query=query, tablet_id=tablet, limit=limit)
-        print_search_results(query, results, as_json=ctx.obj["as_json"])
+        print_search_results(query, results, as_json=as_json)
     except LockthardError as e:
         _handle_error(e)
 
@@ -119,28 +129,34 @@ def tablets():
 
 
 @tablets.command(name="list")
+@click.option("--json", "-j", "as_json_local", is_flag=True, default=False,
+              help="Salida en JSON bruto (ideal para scripts y agentes).")
 @click.option("--query", "-q", help="Filtrar tablets por título o categoría.")
 @click.pass_context
-def list_tablets_cmd(ctx: click.Context, query: Optional[str]):
+def list_tablets_cmd(ctx: click.Context, as_json_local: bool, query: Optional[str]):
     """Lista los 61+ tablets y categorías disponibles."""
     client: LockthardClient = ctx.obj["client"]
+    as_json = _get_as_json(ctx, as_json_local)
     try:
         res = client.list_tablets(query=query)
-        print_tablets_list(res, as_json=ctx.obj["as_json"])
+        print_tablets_list(res, as_json=as_json)
     except LockthardError as e:
         _handle_error(e)
 
 
 @tablets.command(name="get")
+@click.option("--json", "-j", "as_json_local", is_flag=True, default=False,
+              help="Salida en JSON bruto (ideal para scripts y agentes).")
 @click.argument("tablet_id")
 @click.option("--limit", "-l", type=int, help="Límite de herramientas a devolver.")
 @click.pass_context
-def get_tablet_cmd(ctx: click.Context, tablet_id: str, limit: Optional[int]):
+def get_tablet_cmd(ctx: click.Context, as_json_local: bool, tablet_id: str, limit: Optional[int]):
     """Obtiene el contenido completo de un tablet por su ID (ej. ocr, open-source)."""
     client: LockthardClient = ctx.obj["client"]
+    as_json = _get_as_json(ctx, as_json_local)
     try:
         res = client.get_tablet(tablet_id=tablet_id, limit=limit)
-        print_tablet_content(res, as_json=ctx.obj["as_json"])
+        print_tablet_content(res, as_json=as_json)
     except LockthardError as e:
         _handle_error(e)
 
@@ -152,26 +168,32 @@ def tools():
 
 
 @tools.command(name="get")
+@click.option("--json", "-j", "as_json_local", is_flag=True, default=False,
+              help="Salida en JSON bruto (ideal para scripts y agentes).")
 @click.argument("tool_id")
 @click.pass_context
-def get_tool_cmd(ctx: click.Context, tool_id: str):
+def get_tool_cmd(ctx: click.Context, as_json_local: bool, tool_id: str):
     """Obtiene los detalles y comandos recomendados de una herramienta específica."""
     client: LockthardClient = ctx.obj["client"]
+    as_json = _get_as_json(ctx, as_json_local)
     try:
         res = client.get_tool_details(tool_id=tool_id)
-        print_tool_details(res, as_json=ctx.obj["as_json"])
+        print_tool_details(res, as_json=as_json)
     except LockthardError as e:
         _handle_error(e)
 
 
 @cli.command(name="cli-tools")
+@click.option("--json", "-j", "as_json_local", is_flag=True, default=False,
+              help="Salida en JSON bruto (ideal para scripts y agentes).")
 @click.pass_context
-def cli_tools_cmd(ctx: click.Context):
+def cli_tools_cmd(ctx: click.Context, as_json_local: bool):
     """Lista las herramientas especializadas de línea de comandos en LOCKTHARD."""
     client: LockthardClient = ctx.obj["client"]
+    as_json = _get_as_json(ctx, as_json_local)
     try:
         res = client.get_cli_tools()
-        print_cli_tools(res, as_json=ctx.obj["as_json"])
+        print_cli_tools(res, as_json=as_json)
     except LockthardError as e:
         _handle_error(e)
 
@@ -182,12 +204,6 @@ def guide():
     print_agent_guide()
 
 
-@cli.command()
-def skill():
-    """Genera la especificación SKILL.md completa para que un Agente de IA la importe."""
-    print_agent_skill()
-
-
 def main():
     cli(obj={})
 

{lockthard_cli-0.1.3 → lockthard_cli-0.2.0}/lockthard_cli/formatters.py

@@ -127,22 +127,36 @@ def print_tablet_content(tablet_data: Dict[str, Any], as_json: bool = False):
         console.print(Panel(f"[bold white]{title}[/bold white]\n[dim]{tablet_data.get('description', '')}[/dim]", border_style="cyan"))
         
         if items:
-            table = Table(title=f"Herramientas en {title} ({len(items)})", show_header=True)
-            table.add_column("Nombre", style="bold green")
-            table.add_column("Descripción", style="white")
-            table.add_column("Enlace", style="blue")
-
+            # Group items by section
+            sections: Dict[str, List[Dict[str, Any]]] = {}
             for item in items:
-                desc = item.get("description") or item.get("desc") or ""
-                url = item.get("url") or item.get("href") or item.get("repo") or "-"
-                table.add_row(str(item.get("name") or "-"), desc, str(url))
-            console.print(table)
+                sec_name = item.get("section") or "General"
+                sections.setdefault(sec_name, []).append(item)
+
+            for sec_title, sec_items in sections.items():
+                section_header = f"📁 {sec_title}" if sec_title != "General" else f"🛠️ Herramientas ({len(sec_items)})"
+                table = Table(title=section_header, show_header=True, header_style="bold yellow")
+                table.add_column("Nombre", style="bold green")
+                table.add_column("Descripción", style="white")
+                table.add_column("Enlace", style="blue")
+
+                for item in sec_items:
+                    desc = item.get("description") or item.get("desc") or ""
+                    url = item.get("url") or item.get("href") or item.get("repo") or "-"
+                    table.add_row(str(item.get("name") or "-"), desc, str(url))
+                console.print(table)
         else:
             console.print("[yellow]No hay herramientas registradas en esta tablet.[/yellow]")
     else:
         print(f"=== {title} ===")
+        sections: Dict[str, List[Dict[str, Any]]] = {}
         for item in items:
-            print(f"- {item.get('name')}: {item.get('url')}")
+            sec_name = item.get("section") or "General"
+            sections.setdefault(sec_name, []).append(item)
+        for sec_title, sec_items in sections.items():
+            print(f"\n--- {sec_title} ---")
+            for item in sec_items:
+                print(f"- {item.get('name')}: {item.get('url')}")
 
 
 def print_tool_details(tool: Dict[str, Any], as_json: bool = False):
@@ -233,45 +247,5 @@ Bienvenido a la CLI de **LOCKTHARD**. Esta interfaz permite a Agentes de IA (Cla
         print(guide_md)
 
 
-def print_agent_skill():
-    skill_content = """---
-name: lockthard
-description: "Scriptable CLI and AI agent client for LOCKTHARD (lockthard.es). Allows searching 2100+ AI tools, exploring 81+ tablets, retrieving tool installation commands, and inspecting tool details with minimum token overhead."
-version: 0.1.0
----
-
-# LOCKTHARD CLI - Agent Skill Guide
-
-Use this CLI to query the LOCKTHARD AI tools directory, find specific tools, get installation/setup commands, and browse tablets.
-
-## Authentication
-Set the environment variable `LOCKTHARD_API_KEY`:
-```bash
-export LOCKTHARD_API_KEY="lk_your_token"
-```
-
-## Recommended Workflow for AI Agents
-Always use the `--json` (`-j`) flag to receive clean JSON output.
-
-1. **Verify status:** `lockthard ping`
-2. **Search tools:** `lockthard search "ocr" --json`
-3. **List all tablets:** `lockthard tablets list --json`
-4. **Get tablet tools:** `lockthard tablets get ocr --json`
-5. **Get tool details:** `lockthard tools get "Chandra OCR" --json`
-6. **List CLI tools:** `lockthard cli-tools --json`
-
-## Commands Reference
-
-| Command | Description | Example |
-|---|---|---|
-| `lockthard ping` | Check connection & auth status | `lockthard ping` |
-| `lockthard search <query>` | Search 2100+ tools | `lockthard search "ocr" -j` |
-| `lockthard tablets list` | List 81+ tablets | `lockthard tablets list -j` |
-| `lockthard tablets get <id>` | Inspect tablet content | `lockthard tablets get open-source -j` |
-| `lockthard tools get <id>` | Detailed tool info & CLI commands | `lockthard tools get "copilotkit" -j` |
-| `lockthard cli-tools` | List dedicated CLI tools | `lockthard cli-tools -j` |
-| `lockthard guide` | Show agent guide | `lockthard guide` |
-| `lockthard skill` | Output this SKILL.md definition | `lockthard skill` |
-"""
-    print(skill_content)
+
 

{lockthard_cli-0.1.3 → lockthard_cli-0.2.0}/lockthard_cli.egg-info/PKG-INFO

@@ -1,92 +1,92 @@
-Metadata-Version: 2.4
-Name: lockthard-cli
-Version: 0.1.3
-Summary: Super efficient CLI for LOCKTHARD AI tools directory and agents
-Author-email: Lockthard Team <info@lockthard.es>
-License: MIT
-Project-URL: Homepage, https://lockthard.es
-Keywords: cli,ai-tools,agents,mcp,lockthard
-Classifier: Development Status :: 4 - Beta
-Classifier: Environment :: Console
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Utilities
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-Requires-Dist: click>=8.1.0
-Requires-Dist: requests>=2.28.0
-Requires-Dist: rich>=13.0.0
-
-# LOCKTHARD CLI (`lockthard`)
-
-A super efficient, scriptable command-line interface and AI agent client for **LOCKTHARD** (https://lockthard.es).
-
-Allows both human developers and autonomous AI agents (Claude Code, Antigravity, Aider, Cursor, etc.) to query, search, and inspect 61+ tablets and 1200+ AI tools with minimum token usage and zero prompt overhead.
-
-## Installation
-
-```bash
-pip install lockthard-cli
-```
-
-Or run without installing:
-
-```bash
-pipx run lockthard-cli --help
-```
-
-## Quick Start
-
-### 1. Authentication
-Get your API key from [lockthard.es](https://lockthard.es).
-
-- **For AI Agents & CI/CD:**
-  ```bash
-  export LOCKTHARD_API_KEY="lk_your_token_here"
-  ```
-- **Interactive Browser Login (Humans):**
-  ```bash
-  lockthard login
-  ```
-- **Manual Login:**
-  ```bash
-  lockthard login --token "lk_your_token_here"
-  ```
-
-### 2. Commands
-
-```bash
-# Ping service
-lockthard ping
-
-# Search tools (returns concise ASCII table)
-lockthard search "ocr"
-
-# Search tools in raw JSON (for agents / jq)
-lockthard search "ocr" --json
-
-# List all tablets
-lockthard tablets list
-
-# Inspect a specific tablet
-lockthard tablets get ocr
-
-# Inspect tool details
-lockthard tools get "Chandra OCR"
-
-# Display CLI agent guide
-lockthard guide
-```
-
-## Options
-
-- `--json` / `-j`: Output raw JSON without Rich styling.
-- `--url` / `-u`: Override base server URL (default: `https://lockthard.es`).
-- `--token` / `-t`: Override API token.
-
-## License
-
-MIT License
+Metadata-Version: 2.4
+Name: lockthard-cli
+Version: 0.2.0
+Summary: CLI and AI agent client for LOCKTHARD — query 2100+ curated AI tools across 86+ tablets
+Author-email: Lockthard Team <info@lockthard.es>
+License: MIT
+Project-URL: Homepage, https://lockthard.es
+Keywords: cli,ai-tools,agents,mcp,lockthard
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.1.0
+Requires-Dist: requests>=2.28.0
+Requires-Dist: rich>=13.0.0
+
+# LOCKTHARD CLI (`lockthard`)
+
+A super efficient, scriptable command-line interface and AI agent client for **LOCKTHARD** (https://lockthard.es).
+
+Allows both human developers and autonomous AI agents (Claude Code, Antigravity, Aider, Cursor, etc.) to query, search, and inspect 61+ tablets and 1200+ AI tools with minimum token usage and zero prompt overhead.
+
+## Installation
+
+```bash
+pip install lockthard-cli
+```
+
+Or run without installing:
+
+```bash
+pipx run lockthard-cli --help
+```
+
+## Quick Start
+
+### 1. Authentication
+Get your API key from [lockthard.es](https://lockthard.es).
+
+- **For AI Agents & CI/CD:**
+  ```bash
+  export LOCKTHARD_API_KEY="lk_your_token_here"
+  ```
+- **Interactive Browser Login (Humans):**
+  ```bash
+  lockthard login
+  ```
+- **Manual Login:**
+  ```bash
+  lockthard login --token "lk_your_token_here"
+  ```
+
+### 2. Commands
+
+```bash
+# Ping service
+lockthard ping
+
+# Search tools (returns concise ASCII table)
+lockthard search "ocr"
+
+# Search tools in raw JSON (for agents / jq)
+lockthard search "ocr" --json
+
+# List all tablets
+lockthard tablets list
+
+# Inspect a specific tablet
+lockthard tablets get ocr
+
+# Inspect tool details
+lockthard tools get "Chandra OCR"
+
+# Display CLI agent guide
+lockthard guide
+```
+
+## Options
+
+- `--json` / `-j`: Output raw JSON without Rich styling.
+- `--url` / `-u`: Override base server URL (default: `https://lockthard.es`).
+- `--token` / `-t`: Override API token.
+
+## License
+
+MIT License

{lockthard_cli-0.1.3 → lockthard_cli-0.2.0}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "lockthard-cli"
-version = "0.1.3"
-description = "Super efficient CLI for LOCKTHARD AI tools directory and agents"
+version = "0.2.0"
+description = "CLI and AI agent client for LOCKTHARD — query 2100+ curated AI tools across 86+ tablets"
 readme = "README.md"
 license = { text = "MIT" }
 requires-python = ">=3.10"
@@ -37,3 +37,6 @@ lockthard = "lockthard_cli.cli:main"
 
 [tool.setuptools.packages.find]
 where = ["."]
+
+[tool.setuptools.package-data]
+"*" = ["SKILL.md"]

{lockthard_cli-0.1.3 → lockthard_cli-0.2.0}/setup.cfg

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