llm-context

Contexto de LLM

LLM Context es una herramienta que ayuda a los desarrolladores a inyectar rápidamente contenido relevante de proyectos de código/texto en las interfaces de chat de Modelos de Lenguaje Grandes (LMM). Aprovecha los patrones .gitignore para la selección inteligente de archivos y proporciona un flujo de trabajo optimizado en el portapapeles mediante la línea de comandos, así como integración directa con LLM mediante el Protocolo de Contexto de Modelo (MCP).

Nota : Este proyecto se desarrolló en colaboración con varios Claude Sonnets (3.5, 3.6 y 3.7, y más recientemente también con Grok-3), utilizando el propio LLM Context para compartir código durante el desarrollo. Todo el código del repositorio está seleccionado por mí 😇, @restlessronin.

Cambios importantes en la versión v0.3.0

Hemos adoptado un sistema de reglas basado en Markdown (con la introducción de YAML) que reemplaza los perfiles anteriores basados en TOML/YAML. Este cambio radical afecta la configuración. Consulte la Guía del usuario para obtener más información sobre el nuevo formato de reglas y cómo usarlo.

¿Por qué LLM Context?

Para una exploración en profundidad del razonamiento detrás de LLM Context y su enfoque del desarrollo asistido por IA, consulte nuestro artículo: LLM Context: Aprovechar Vanilla AI Chats para el desarrollo

Para ver LLM Context en acción con ejemplos y flujos de trabajo del mundo real, lea: Magia de contexto completo: cuando la IA finalmente comprende todo su proyecto

Patrones de uso actuales

• Integración directa con LLM : integración nativa con Claude Desktop a través del protocolo MCP
• Compatibilidad con interfaz de chat : funciona con cualquier interfaz de chat LLM a través de CLI/portapapeles
  • Optimizado para interfaces con contexto persistente como Proyectos Claude y GPT personalizados
  • Funciona igualmente bien con interfaces de chat estándar.
• Tipos de proyecto : Adecuado para repositorios de código y colecciones de documentos de texto/markdown/html
• Tamaño del proyecto : Optimizado para proyectos que se ajusten al contexto de un LLM. Se está desarrollando compatibilidad con proyectos grandes.

Instalación

Instalar LLM Context usando uv :

Para actualizar a la última versión:

Advertencia : LLM Context se encuentra en desarrollo activo. Las actualizaciones pueden sobrescribir los archivos de configuración con el prefijo lc- . Por este motivo, recomendamos que todos los archivos de configuración tengan control de versiones.

Inicio rápido

MCP con Claude Desktop

Agregar a 'claude_desktop_config.json':

Una vez configurado, puedes empezar a trabajar con tu proyecto de dos sencillas maneras:

1. Diga: "Me gustaría trabajar con mi proyecto". Claude le pedirá la ruta raíz del proyecto.
2. O especifique directamente: "Me gustaría trabajar con mi proyecto /ruta/a/su/proyecto" Claude cargará automáticamente el contexto del proyecto.

Flujo de trabajo preferido: combinar la interfaz de usuario del proyecto con MCP

Para obtener resultados óptimos, combine el contexto inicial mediante la interfaz de usuario de conocimiento del proyecto de Claude con el acceso dinámico al código mediante MCP. Esto proporciona una comprensión completa y acceso a los cambios más recientes. Consulte Full Context Magic para obtener más información y ejemplos.

Inicio rápido de CLI y flujo de trabajo típico

1. Navegue al directorio raíz de su proyecto
2. Inicializar el repositorio: lc-init (solo es necesario una vez)
3. Seleccionar archivos: lc-sel-files
4. (Opcional) Revisar los archivos seleccionados en .llm-context/curr_ctx.yaml
5. Generar contexto: lc-context (con indicadores opcionales: -p para solicitud, -u para notas de usuario)
6. Úselo con su interfaz preferida:

• Conocimiento del proyecto (Claude Pro): pegar en la sección de conocimiento
• Conocimiento de GPT (GPT personalizados): pegar en la sección de conocimiento
• Chats regulares: use lc-context -p para incluir instrucciones

7. Cuando el LLM solicita archivos adicionales:
   • Copiar la lista de archivos del LLM
   • Ejecutar lc-clip-files
   • Pegue el contenido nuevamente en el LLM

Comandos básicos

• lc-init : Inicializar la configuración del proyecto
• lc-set-rule <n> : Cambiar reglas (las reglas del sistema tienen el prefijo "lc-")
• lc-sel-files : Seleccionar archivos para incluir
• lc-sel-outlines : Seleccionar archivos para la generación del esquema
• lc-context [-p] [-u] [-f FILE] : Generar y copiar contexto
  • -p : Incluir instrucciones rápidas
  • -u : Incluir notas de usuario
  • -f FILE : Escribe en el archivo de salida
• lc-prompt : Generar instrucciones de proyecto para LLM
• lc-clip-files : Procesar solicitudes de archivos LLM
• lc-changed : Lista de archivos modificados desde la última generación de contexto
• lc-outlines : Genera esquemas para archivos de código
• lc-clip-implementations : Extrae implementaciones de código solicitadas por LLM (no es compatible con C/C++)

Características y uso avanzado

LLM Context proporciona funciones avanzadas para personalizar cómo se captura y presenta el contenido del proyecto:

• Selección inteligente de archivos mediante patrones .gitignore
• Múltiples perfiles basados en reglas para diferentes casos de uso
  • Las reglas del sistema (con el prefijo "lc-") proporcionan una funcionalidad predeterminada
  • Las reglas definidas por el usuario se pueden crear de forma independiente o ampliar las reglas existentes.
• Características de navegación de código:
  1. Esquemas de código inteligentes : permite a los LLM ver la estructura de alto nivel de su base de código con esquemas generados automáticamente que resaltan definiciones importantes
  2. Extracción de implementación de definiciones : pegue implementaciones completas de definiciones específicas solicitadas por los LLM después de revisar los esquemas de código, utilizando el comando lc-clip-implementations
• Plantillas y mensajes personalizables

Consulte nuestra Guía del usuario para obtener documentación detallada de estas funciones.

Herramientas similares

Consulte nuestra lista completa de alternativas : la gran cantidad de herramientas que abordan este problema demuestra su importancia para la comunidad de desarrolladores.

Expresiones de gratitud

LLM Context evoluciona a partir de un linaje de herramientas de desarrollo asistidas por IA:

• Este proyecto sucede a LLM Code Highlighter , una biblioteca TypeScript que desarrollé para la integración IDE.
• El concepto se originó a partir de mi trabajo en RubberDuck y continuó con contribuciones posteriores a Continue .
• El Resaltador de Código LLM se inspiró en gran medida en Aider Chat . Trabajé con GPT-4 para traducir varios módulos de Python de Aider Chat a TypeScript, manteniendo la funcionalidad a la vez que reestructuraba el código.
• Este proyecto utiliza archivos de consulta de etiquetas tree-sitter de Aider Chat.
• LLM Context ejemplifica el poder del desarrollo asistido por IA, pasando de Python a TypeScript y de regreso a Python con la ayuda de GPT-4 y Claude-3.5-Sonnet.

Estoy agradecido por las innovaciones de la comunidad de código abierto y la asistencia de la IA que han dado forma a la evolución de este proyecto.

Agradezco la ayuda de Claude-3.5-Sonnet en el desarrollo de este proyecto.

Licencia

Este proyecto está licenciado bajo la Licencia Apache, versión 2.0. Consulte el archivo de LICENCIA para obtener más información.