Qué es

GitHub responde la mayoría de las preguntas sobre el presente y casi ninguna sobre el pasado.

La API de tráfico sirve catorce días y olvida. El feed de actividad guarda los últimos trescientos eventos, y ninguno de hace más de treinta días. La bandeja de notificaciones descarta toda notificación a los tres meses, leída o no, salvo que se haya guardado. Los logs de los jobs se borran por omisión a los noventa días. La lista de estrellas dice cuándo se dio cada una, pero desde julio de 2026 solo a los administradores y colaboradores del repositorio, y solo si se pregunta antes de que la lista sea lo bastante larga como para que recorrerla salga caro. Nada de eso queda archivado en ningún sitio salvo que uno lo archive.

ghchronicle recorre esas superficies según un horario y escribe cada observación como un punto sellado con la fecha en que la cosa ocurrió de verdad, de modo que dentro de un año la pregunta “a qué velocidad fusionábamos en julio” siga teniendo respuesta.

ghchronicle -config config.yaml

Es un único binario estático de Go sin dependencias en tiempo de ejecución, y envía por push a todos los almacenes que soporta, así que se ejecuta allí donde los alcance: un servidor, un contenedor, un workflow programado.

La tarjeta no es el objetivo

También sabe dibujar una tarjeta SVG de resumen para un README de perfil. Eso es una función secundaria. La razón por la que el proyecto existe es la ingesta.

Las seis palabras que usa todo lo demás

Palabra	Qué significa aquí
familia	Un colector, nombrado en la configuración: actions, stars, issues. Hay 34
grupo	Un conjunto de familias con nombre, para encender o apagar un área entera: ci, security, audience. Hay 8
medida	Un tipo de fila del almacén, nombrada gh_*: gh_star, gh_workflow_run. Hay 95
punto	Una fila: una medida, sus etiquetas, sus campos y la fecha en que ocurrió la cosa
pasada	Un recorrido por las familias a las que les toca, que es lo que hace el proceso en bucle
relleno	Una ejecución con -backfill, que recorre la historia en vez del incremento

ghchronicle -groups imprime los grupos con sus familias, y ghchronicle -config config.yaml -list imprime los repositorios que cubriría una pasada.

Por dónde seguir

• Inicio rápido: de cero a una primera pasada.
• El token: qué ámbito compra qué familia.
• La fecha del punto: la idea de diseño de la que se sigue todo lo demás.