Repolode
cyberchitta

cyberchitta/llm-context.py

Una CLI de Python y un servidor MCP que permiten a agentes de programación y chats obtener el contexto de código adecuado mediante reglas reutilizables para seleccionar archivos.

Estrellas
308
Forks
26
Issues abiertos
5
Último commit
hace 19 días

¿Qué es?

llm-context.py es una herramienta para incluir los archivos de código fuente adecuados en el contexto de un LLM. En lugar de copiar archivos manualmente o enviar un repositorio entero, defines la selección mediante una regla: un archivo YAML con instrucciones opcionales en Markdown que enumera los archivos completos y los archivos de apoyo que se deben incluir como extractos. Después, la herramienta reúne el código que coincide en un único contexto, con un listado de archivos que indica cuáles están incluidos y cuáles no.

Las reglas se pueden combinar y se agrupan por categoría, así que puedes cambiar entre tareas como revisar código o preparar documentación modificando las reglas en lugar de las listas de archivos. Los archivos que planeas editar se incluyen completos, mientras que el código de apoyo se reduce a firmas y definiciones mediante el análisis de la estructura del código. Cada paquete incluye una marca de tiempo para que las herramientas puedan indicar qué archivos faltan o han cambiado desde que se generó.

El contexto se puede entregar de tres maneras: imprimirlo en stdout para pasarlo a otro agente, como claude -p; copiarlo al portapapeles para pegarlo en un chat; o servirlo mediante el Model Context Protocol para que un modelo pueda solicitar archivos por sí mismo. Al ejecutar lc-init se instala en el proyecto una skill que enseña a un agente de programación a escribir y verificar estas reglas.

Funciones clave

  • 01Selecciona archivos mediante reglas YAML reutilizables, combinables y que puedes cambiar según la tarea.
  • 02Incluye el contenido completo de los archivos que vas a editar y esquemas del código de los archivos de apoyo.
  • 03Permite previsualizar los archivos que selecciona una regla, incluidos los símbolos utilizados pero no incluidos.
  • 04Envía el resultado a stdout para pasarlo a otro proceso, al portapapeles o a un servidor MCP.
  • 05Ofrece herramientas MCP para solicitar archivos que falten o hayan cambiado durante una sesión.
  • 06Instala una skill para agentes que escribe y valida las reglas del proyecto.

Casos de uso

  • Proporcionar a un agente de programación contexto específico para una funcionalidad o corrección de errores.
  • Pasar código seleccionado a un agente secundario ejecutado desde la línea de comandos.
  • Pegar en un modelo de chat una instantánea acotada del código para que la revise.
  • Mantener reglas de contexto para tareas de revisión de código y documentación en un mismo repositorio.

Inicio rápido

  1. 1

    Instala la herramienta con uv

    uv tool install "llm-context>=0.6.0"
  2. 2

    Ejecuta lc-init en la raíz de tu proyecto para instalar la skill

    lc-init

Antes de usarlo

  • La documentación completa está en un archivo de agent skill, por lo que el README solo sirve como página de inicio.

En colecciones

Temas

Preguntas frecuentes

¿Qué es llm-context.py?
Una CLI de Python y un servidor MCP que permiten a agentes de programación y chats obtener el contexto de código adecuado mediante reglas reutilizables para seleccionar archivos. llm-context.py es una herramienta para incluir los archivos de código fuente adecuados en el contexto de un LLM. En lugar de copiar archivos manualmente o enviar un repositorio entero, defines la selección mediante una regla: un archivo YAML con instrucciones opcionales en Markdown que enumera los archivos completos y los archivos de apoyo que se deben incluir como extractos. Después, la herramienta reúne el código que coincide en un único contexto, con un listado de archivos que indica cuáles están incluidos y cuáles no.
¿llm-context.py es gratuito? ¿Qué licencia tiene?
llm-context.py es open source bajo la licencia Apache-2.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿llm-context.py sigue mantenido?
Mantenimiento activo. El último commit de llm-context.py fue el 19 oct 2026.
¿Para qué puedo usar llm-context.py?
Proporcionar a un agente de programación contexto específico para una funcionalidad o corrección de errores. Pasar código seleccionado a un agente secundario ejecutado desde la línea de comandos. Pegar en un modelo de chat una instantánea acotada del código para que la revise. Mantener reglas de contexto para tareas de revisión de código y documentación en un mismo repositorio.
¿Cómo se instala llm-context.py?
Instala la herramienta con uv: uv tool install "llm-context>=0.6.0" Ejecuta lc-init en la raíz de tu proyecto para instalar la skill: lc-init
¿Dónde consigo llm-context.py?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/cyberchitta/llm-context.py

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados