CTX: Context as Code (CaC) tool

Official
by context-hub
MIT License
80
  • Apple
  • Linux

Integrations

  • Extracts code changes from Git commits and diffs to provide contextual information about your project's history

  • Gathers code from GitHub repositories to provide context about your project to LLMs

  • Supports specialized handling of PHP code, including the ability to extract PHP signatures without implementation details

ctx: El eslabón perdido entre tu código base y tu LLM. Herramienta de Contexto como Código (CaC) con servidor MCP integrado.

Tabla de contenido

CTX es una herramienta creada para resolver un gran problema al chatear con LLM como ChatGPT o Claude: darles suficiente contexto sobre tu proyecto .

Hay un artículo sobre Context Generator en Medium que explica la motivación detrás del proyecto y el problema que resuelve.

Al usar IA en el desarrollo, el contexto no solo es útil, sino fundamental. En lugar de copiar o explicar manualmente todo el código base cada vez, ctx crea automáticamente archivos de contexto limpios y organizados a partir de:

  • Archivos de código,
  • Repositorios de GitHub y Gitlab,
  • Confirmaciones y diferencias de Git
  • Páginas web (URL) con selectores CSS,
  • Servidores MCP
  • y texto plano.

Fue creado para resolver un problema común: proporcionar de manera eficiente a los modelos de lenguaje de IA como Claude el contexto necesario sobre su base de código.

Cómo funciona

  1. Recopila código de archivos, directorios, repositorios de GitHub o Gitlab, páginas web o texto sin formato.
  2. Busca archivos específicos a través de coincidencia de patrones, búsqueda de contenido, tamaño o filtros de fecha.
  3. Aplica modificadores opcionales (como extraer firmas PHP sin detalles de implementación)
  4. Organiza el contenido en documentos de rebajas bien estructurados
  5. Guarda archivos de contexto listos para ser compartidos con LLM
  6. Opcionalmente, sirve contexto a través de un servidor MCP, lo que permite que los asistentes de IA como Claude accedan directamente a la información del proyecto.

Inicio rápido

Comenzar a usar CTX es muy sencillo. Sigue estos sencillos pasos para crear tu primer archivo de contexto.

1. Instalar CTX

Descargue e instale la herramienta utilizando nuestro script de instalación:

curl -sSL https://raw.githubusercontent.com/context-hub/generator/main/download-latest.sh | sh

Esto instala el comando ctx en su sistema (normalmente en /usr/local/bin ).

¿Quieres más opciones? Consulta la Guía de instalación completa para ver métodos de instalación alternativos.

2. Inicializar un archivo de configuración

Cree un nuevo archivo de configuración en el directorio de su proyecto:

ctx init

Esto genera un archivo context.yaml con una estructura básica para ayudarle a comenzar.

Consulte la Referencia de comandos para conocer todos los comandos y opciones disponibles.

3. Describe la estructura de tu proyecto

Edite el archivo context.yaml generado para especificar qué código o contenido desea incluir.

Por ejemplo:

$schema: 'https://raw.githubusercontent.com/context-hub/generator/refs/heads/main/json-schema.json' documents: - description: "User Authentication System" outputPath: "auth-context.md" sources: - type: file description: "Authentication Controllers" sourcePaths: - src/Auth filePattern: "*.php" - type: file description: "Authentication Models" sourcePaths: - src/Models filePattern: "*User*.php"

Esta configuración reunirá todos los archivos PHP del directorio src/Auth y cualquier archivo PHP que contenga "Usuario" en su nombre del directorio src/Models .

¿Necesita una configuración más avanzada?

4. Construir el contexto

Genere su archivo de contexto ejecutando:

ctx

CTX procesará su configuración y creará el archivo de salida especificado ( auth-context.md en nuestro ejemplo).

Consejo : Configure el registro con -v , -vv o -vvv para obtener una salida detallada

5. Compartir con un LLM

Sube o pega el archivo de contexto generado en tu LLM favorito (como ChatGPT o Claude). Ahora puedes hacer preguntas específicas sobre tu código base, y el LLM tendrá el contexto necesario para brindarte asistencia precisa.

Ejemplo de mensaje:

Compartí el código de mi sistema de autenticación con ustedes. ¿Podrían ayudarme a identificar posibles vulnerabilidades de seguridad en el proceso de registro de usuarios?

Próximos pasos: consulte Desarrollo con generador de contexto para conocer las mejores prácticas sobre cómo integrar la generación de contexto en su flujo de trabajo de desarrollo impulsado por IA.

¡Listo! Ya estás listo para aprovechar los LLM con el contexto adecuado de tu código fuente.

6. Conéctese a Claude AI (opcional)

Para una experiencia más fluida, puede conectar Context Generator directamente a Claude AI mediante el servidor MCP:

Hay un servidor MCP integrado que le permite conectar Claude AI directamente a su base de código.

Apunte el cliente MCP al servidor generador de contexto:

{ "mcpServers": { "ctx": { "command": "ctx server -c /path/to/your/project" } } }

Nota: Lea más sobre el servidor MCP para obtener instrucciones de configuración detalladas.

¡Ahora puedes hacerle preguntas a Claude sobre tu base de código sin tener que cargar manualmente los archivos de contexto!

Documentación completa

Para obtener la documentación completa, incluidas todas las funciones y opciones de configuración disponibles, visite:

https://docs.ctxgithub.com


Licencia

Este proyecto está licenciado bajo la licencia MIT.

-
security - not tested
A
license - permissive license
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

CTX es una herramienta creada para resolver un gran problema al chatear con LLM como ChatGPT o Claude: brindarles suficiente contexto sobre tu proyecto.

  1. Table of Contents
    1. How it works
      1. Quick Start
        1. 1. Install CTX
        2. 2. Initialize a Configuration File
        3. 3. Describe Your Project Structure
        4. 4. Build the Context
        5. 5. Share with an LLM
        6. 6. Connect to Claude AI (Optional)
        7. Full Documentation

      Related MCP Servers

      • A
        security
        A
        license
        A
        quality
        Enables integration of Perplexity's AI API with LLMs, delivering advanced chat completion by utilizing specialized prompt templates for tasks like technical documentation, code review, and API documentation.
        Last updated -
        1
        94
        8
        JavaScript
        MIT License
        • Linux
      • -
        security
        F
        license
        -
        quality
        A Model Context Protocol server for Claude Desktop that provides structured memory management across chat sessions, allowing Claude to maintain context and build a knowledge base within project directories.
        Last updated -
        TypeScript
      • A
        security
        F
        license
        A
        quality
        A model context protocol server that allows interaction with TriliumNext Notes, providing tools to create, search, retrieve, update, and delete notes through natural language commands.
        Last updated -
        5
        1
        JavaScript
        • Apple
      • -
        security
        A
        license
        -
        quality
        An MCP server that provides integration with Microsoft's AutoGen framework, enabling multi-agent conversations through a standardized interface.
        Last updated -
        1
        Python
        MIT License

      View all related MCP servers

      ID: qn88dl0i3i