/setup

Context Sources Setup

Este comando configura el plugin Context Sources para su primer uso.

Pasos de configuración

1. Verificar estructura del plugin

Primero verifico que el plugin esté correctamente instalado:

ls -la $PLUGIN_DIR/

Deberías ver:

• .claude-plugin/plugin.json
• scripts/ con los proveedores Python
• commands/ con los comandos
• config/sources.example.yaml

2. Crear directorio de configuración

Creo el directorio donde se guardarán las configuraciones del usuario:

mkdir -p ~/.context-sources
echo "✅ Directorio de configuración creado"

3. Crear archivo de configuración

Si no existe un archivo de configuración, creo uno inicial basado en el ejemplo:

if [ ! -f .context-sources/sources.yaml ]; then
  mkdir -p .context-sources
  cp $PLUGIN_DIR/config/sources.example.yaml .context-sources/sources.yaml
  echo "✅ Archivo sources.yaml creado en .context-sources/"
  echo "📝 Edita .context-sources/sources.yaml para configurar tus fuentes"
else
  echo "ℹ️ Ya existe .context-sources/sources.yaml"
fi

4. Verificar dependencias Python

Para los proveedores gdrive y obsidian avanzado, necesitas algunas dependencias:

pip install -q google-api-python-client google-auth-httplib2 google-auth-oauthlib PyYAML python-frontmatter 2>/dev/null && echo "✅ Dependencias Python instaladas" || echo "⚠️ Algunas dependencias no se pudieron instalar (opcional)"

5. Configurar proveedores específicos

Dependiendo de los proveedores que uses:

Filesystem (sin configuración adicional)

Solo necesitas definir las rutas en sources.yaml.

Google Drive

Ejecuta /context-sources:gdrive:setup para configurar credenciales.

Obsidian

Solo necesitas apuntar a la ruta de tu vault en sources.yaml.

MCP

Asegúrate de que el servidor MCP esté configurado en Claude Code settings.

Configuración de sources.yaml

El archivo .context-sources/sources.yaml define tus fuentes. Estructura básica:

version: "1.0"

sources:
  mi-fuente:
    description: "Descripción de cuándo usar esta fuente"
    provider: filesystem  # o gdrive, obsidian, mcp
    path: "./mi-directorio"
    keywords: [palabra1, palabra2]
    auto_load: false
    priority: medium
    read_only: true

Campos importantes

Campo	Descripción
description	Muy importante - Define cuándo el skill debe sugerir esta fuente
keywords	Palabras que activan la sugerencia de esta fuente
auto_load	Si true, se sugiere automáticamente cuando hay coincidencia
read_only	Si true, no permite escritura con /context-sources:write

Próximos pasos

1. Edita .context-sources/sources.yaml con tus fuentes
2. Ejecuta /context-sources:list para verificar la configuración
3. Prueba /context-sources:load <nombre> para cargar contenido

Comandos disponibles

Comando	Descripción
/context-sources:list	Ver fuentes configuradas
/context-sources:load	Cargar contenido de fuentes
/context-sources:search	Buscar en fuentes
/context-sources:write	Escribir a una fuente
/context-sources:add	Añadir nueva fuente
/context-sources:remove	Eliminar fuente