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