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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lockthard-cli
-Version: 0.2.0
+Version: 0.2.2
 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

lockthard_cli-0.2.2/lockthard_cli/SKILL.md

@@ -0,0 +1,121 @@
+---
+name: lockthard
+description: "LOCKTHARD CLI — query 2100+ curated AI tools across 86+ tablets. Search, browse tablets, get tool details, and investigate repos. Designed for both humans and AI agents."
+version: 0.2.0
+metadata:
+  hermes:
+    tags: [lockthard, tools, ai, search, tablets, mcp]
+    homepage: https://lockthard.es
+---
+
+# LOCKTHARD CLI
+
+CLI para consultar el directorio de herramientas IA de LOCKTHARD (2100+ herramientas, 86+ tablets). Diseñada para humanos (tablas Rich) y agentes IA (JSON limpio).
+
+## Autenticación
+
+```bash
+# Opción 1: Variable de entorno (recomendado para agentes)
+export LOCKTHARD_API_KEY="lk_tu_token"
+
+# Opción 2: Login con token
+lockthard login --token lk_tu_token
+
+# Opción 3: Login interactivo (abre navegador)
+lockthard login
+```
+
+Token guardado en `~/.lockthard/credentials.json` (permisos 0600).
+
+## Flag JSON (`-j` / `--json`)
+
+Para agentes IA: **siempre usa `-j`** para recibir JSON limpio sin formato ANSI.
+
+El flag funciona tanto a nivel global como en cualquier subcommand:
+
+```bash
+lockthard -j tablets list                    # ✅ global
+lockthard tablets list -j                    # ✅ en subcommand
+lockthard -j tablets get vector-knowledge-base  # ✅
+lockthard tablets get vector-knowledge-base -j  # ✅
+```
+
+## Comandos
+
+| Comando | Descripción |
+|---|---|
+| `lockthard ping` | Verificar conexión y autenticación |
+| `lockthard -j search "<query>"` | Buscar herramientas por palabra clave |
+| `lockthard -j tablets list` | Listar todos los tablets disponibles |
+| `lockthard -j tablets get <tablet_id>` | Ver herramientas de un tablet |
+| `lockthard -j tools get "<tool_id>"` | Detalles de una herramienta específica |
+| `lockthard -j cli-tools` | Listar herramientas CLI dedicadas |
+| `lockthard guide` | Guía rápida para agentes |
+
+## Estructura de un Tablet
+
+Cada tablet es una colección curada de herramientas agrupadas por temática. Al obtener un tablet (`lockthard -j tablets get <id>`), recibes:
+
+```json
+{
+  "id": "vector-knowledge-base",
+  "title": "Vector Knowledge Base",
+  "toolCount": 41,
+  "tools": [
+    {
+      "name": "Graphify",
+      "description": "Transforma un proyecto en un knowledge graph...",
+      "url": "https://github.com/safishamsi/graphify",
+      "section": "General",
+      "snippetsCount": 1
+    }
+  ]
+}
+```
+
+### Cómo interpretar las herramientas
+
+- **`section`**: Categoría que agrupa la herramienta. **La sección YA es contexto** — si una herramienta está en "Memoria Y Contexto Para Agentes", eso ya indica su dominio.
+- **`description`**: Descripción textual (puede estar vacía si el nombre + sección + URL son suficientes).
+- **`url`**: Enlace al repositorio o sitio web. **El agente debe investigar esta URL** para obtener más detalles (leer README, verificar instalación, etc.).
+- **`snippetsCount`**: Número de snippets de código o instrucciones adicionales disponibles vía `tools get`.
+
+### Ejemplo: interpretación correcta
+
+```
+Herramienta: "LightRAG"
+Sección:     "RAG" (o "General")
+URL:         https://github.com/HKUDS/LightRAG
+Descripción: (vacía)
+```
+
+**Interpretación correcta:** Es un sistema RAG. La sección indica que es de la categoría RAG. La URL apunta a GitHub donde el agente puede leer el README para entender qué hace.
+
+**Interpretación incorrecta:** ❌ "Herramienta sin descripción, está incompleta."
+
+## Flujo de trabajo recomendado para agentes
+
+1. `lockthard ping` — verificar auth
+2. `lockthard -j tablets list` — ver tablets disponibles
+3. `lockthard -j tablets get <id>` — explorar herramientas de un tablet relevante
+4. Para cada herramienta interesante: **ir al repo/URL y leer documentación**
+5. `lockthard -j tools get "<nombre>"` — detalles específicos con snippets si se necesitan
+
+## Ejemplos de uso
+
+```bash
+# Buscar herramientas de OCR
+lockthard -j search "ocr"
+
+# Ver todo el tablet de cybersecurity
+lockthard -j tablets get cybersecurity
+
+# Ver detalles de una herramienta específica
+lockthard -j tools get "Graphify"
+
+# Listar herramientas CLI
+lockthard -j cli-tools
+
+# Verificar que todo funciona
+lockthard ping
+```

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

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

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

@@ -1,4 +1,6 @@
+import json
 import sys
+from pathlib import Path
 from typing import Optional
 import click
 
@@ -15,7 +17,10 @@ from .formatters import (
     print_tool_details,
     print_cli_tools,
     print_agent_guide,
+    HAS_RICH,
+    console,
 )
+from rich.markdown import Markdown
 
 
 def _handle_error(err: Exception):
@@ -204,6 +209,27 @@ def guide():
     print_agent_guide()
 
 
+@cli.command()
+@click.pass_context
+def skill(ctx: click.Context):
+    """Muestra la SKILL.md integrada del paquete para que un Agente de IA la importe."""
+    try:
+        skill_path = Path(__file__).parent / "SKILL.md"
+        if not skill_path.exists():
+            raise FileNotFoundError(f"SKILL.md no encontrada en {skill_path}")
+        content = skill_path.read_text(encoding="utf-8")
+
+        if ctx.obj.get("as_json"):
+            print(json.dumps({"skill": content}, ensure_ascii=False))
+        else:
+            if HAS_RICH and console:
+                console.print(Markdown(content))
+            else:
+                print(content)
+    except Exception as e:
+        _handle_error(LockthardError(f"No se pudo leer SKILL.md: {e}"))
+
+
 def main():
     cli(obj={})
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lockthard-cli
-Version: 0.2.0
+Version: 0.2.2
 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

{lockthard_cli-0.2.0 → lockthard_cli-0.2.2}/lockthard_cli.egg-info/SOURCES.txt

@@ -1,5 +1,6 @@
 README.md
 pyproject.toml
+lockthard_cli/SKILL.md
 lockthard_cli/__init__.py
 lockthard_cli/auth.py
 lockthard_cli/cli.py

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "lockthard-cli"
-version = "0.2.0"
+version = "0.2.2"
 description = "CLI and AI agent client for LOCKTHARD — query 2100+ curated AI tools across 86+ tablets"
 readme = "README.md"
 license = { text = "MIT" }