¿Qué hace Cobweb?
Núcleo de gobernanza local para habilidades de agentes: CLI (cobweb), demonio (cobwebd), almacenamiento de estado en SQLite y análisis, validación, auditoría y sincronización de SKILL.md.
Descripción general
Cobweb proporciona un conjunto de herramientas para gestionar habilidades de agentes de IA de manera local y segura. Incluye un cliente CLI (cobweb) para operaciones interactivas y un demonio (cobwebd) para ejecución continua en segundo plano.
Características
- Análisis de SKILL.md: Lee y extrae metadatos de archivos SKILL.md.
- Validación: Verifica que las habilidades cumplan con el formato y reglas definidas.
- Auditoría: Registra cambios y accesos a las habilidades para trazabilidad.
- Sincronización: Mantiene actualizadas las habilidades desde repositorios remotos.
- Almacenamiento SQLite: Persiste el estado de las habilidades en una base de datos local.
Instalación
# Clonar el repositorio
git clone https://github.com/nousio/cobweb.git
cd cobweb
# Instalar dependencias
pip install -r requirements.txt
Uso
CLI (cobweb)
# Inicializar un nuevo repositorio de habilidades
cobweb init
# Agregar una habilidad desde un SKILL.md
cobweb add ruta/a/skill.md
# Listar habilidades registradas
cobweb list
# Auditar una habilidad específica
cobweb audit nombre-de-habilidad
Demonio (cobwebd)
# Iniciar el demonio en segundo plano
cobwebd start
# Detener el demonio
cobwebd stop
# Ver estado del demonio
cobwebd status
Configuración
Cobweb busca un archivo de configuración en ~/.cobweb/config.yaml con la siguiente estructura:
# Directorio de almacenamiento de habilidades
skills_dir: ~/.cobweb/skills
# Base de datos SQLite
db_path: ~/.cobweb/state.db
# Repositorio remoto para sincronización
remote: https://github.com/nousio/skills-repo
# Intervalo de sincronización automática (en minutos)
sync_interval: 60
Ejemplos
Validación de un SKILL.md
cobweb validate skill.md
Sincronización manual
cobweb sync
Licencia
Este proyecto está bajo la licencia MIT. Ver el archivo LICENSE para más detalles.