lockthard-cli 0.2.1__tar.gz → 0.2.3__tar.gz

{lockthard_cli-0.2.1 → lockthard_cli-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lockthard-cli
-Version: 0.2.1
+Version: 0.2.3
 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.3/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.1 → lockthard_cli-0.2.3}/lockthard_cli/__init__.py

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

{lockthard_cli-0.2.1 → lockthard_cli-0.2.3}/lockthard_cli/cli.py

@@ -34,7 +34,8 @@ def _get_as_json(ctx: click.Context, local_flag: bool) -> bool:
     return ctx.obj.get("as_json", False) or local_flag
 
 
-@click.group(invoke_without_command=False)
+@click.group(invoke_without_command=False,
+             epilog="Primer uso: lockthard skill  |  Para agentes: lockthard -j skill")
 @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_...).")
 @click.option("--json", "-j", "as_json", is_flag=True, help="Salida en JSON bruto (ideal para scripts y agentes).")
@@ -213,20 +214,11 @@ def guide():
 @click.pass_context
 def skill(ctx: click.Context):
     """Muestra la SKILL.md integrada del paquete para que un Agente de IA la importe."""
-    import importlib.resources
     try:
-        # Try to read SKILL.md bundled with the package
-        pkg_dir = Path(__file__).parent.parent
-        skill_path = pkg_dir / "SKILL.md"
+        skill_path = Path(__file__).parent / "SKILL.md"
         if not skill_path.exists():
-            # Fallback: try importlib.resources
-            try:
-                ref = importlib.resources.files("lockthard_cli").parent.joinpath("SKILL.md")
-                content = ref.read_text(encoding="utf-8")
-            except Exception:
-                raise FileNotFoundError("SKILL.md no encontrada en el paquete.")
-        else:
-            content = skill_path.read_text(encoding="utf-8")
+            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))

{lockthard_cli-0.2.1 → lockthard_cli-0.2.3}/lockthard_cli/formatters.py

@@ -220,12 +220,23 @@ def print_agent_guide():
 
 Bienvenido a la CLI de **LOCKTHARD**. Esta interfaz permite a Agentes de IA (Claude Code, Antigravity, Aider, Cursor) consultar la base de datos de 1200+ herramientas IA con mínimo consumo de tokens.
 
+## SKILL Completa
+
+Para obtener la guía completa optimizada para agentes, ejecuta:
+
+```bash
+lockthard skill
+```
+
+Esto imprime la SKILL.md con toda la referencia: comandos, estructura de tablets, flujo de trabajo y ejemplos.
+
 ## Buenas Prácticas para Agentes
 
-1. **Usa el flag `--json` (o `-j`):** 
-   Devuelve datos limpios y estructurados en JSON en lugar de tablas formateadas con ANSI.
+1. **Usa el flag `-j` (posicion global o en subcommand):**
+   Devuelve datos limpios y estructurados en JSON.
    ```bash
-   lockthard search "ocr" --json
+   lockthard -j search "ocr"
+   lockthard tablets list -j
    ```
 
 2. **Flujo de Trabajo Recomendado:**

{lockthard_cli-0.2.1 → lockthard_cli-0.2.3}/lockthard_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lockthard-cli
-Version: 0.2.1
+Version: 0.2.3
 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.1 → lockthard_cli-0.2.3}/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.1 → lockthard_cli-0.2.3}/pyproject.toml

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