Cómo poner marca de tiempo a los commits de Git sin la línea de comandos
Quieres la propiedad, no el procedimiento. La propiedad es: este hash de commit existía en esta fecha, y aquí hay un recibo que cualquiera puede verificar contra la blockchain de Bitcoin. El procedimiento que quieres evitar es instalar herramientas en cada portátil de desarrollador, perseguir archivos de prueba por hilos de chat y esperar que alguien recuerde cómo funciona el lado de la verificación dos años después, cuando lo pregunte un abogado.
Esta guía muestra cómo poner marca de tiempo a los commits de Git sin herramientas de línea de comandos. Todo lo que sigue ocurre en un navegador y en GitHub. Instalarás una GitHub App una vez, la apuntarás a un repositorio y luego seguirás haciendo commits exactamente como hoy. Timestamp GIT agrupa los hashes de commit cada noche, los ancla en Bitcoin mediante el protocolo OpenTimestamps y devuelve los recibos de prueba a tu repositorio.
Sin CLI. Sin nodo local de Bitcoin. Sin necesidad de conocer el protocolo.
¿Por qué evitar la línea de comandos para el timestamping de Git?
La vía difícil existe, y probablemente puedas imaginar su forma: instalar el cliente de OpenTimestamps en tu máquina, ejecutar un comando contra un archivo que construiste, guardar el recibo resultante en algún sitio y repetirlo siempre que te acuerdes. De ahí surgen de inmediato tres modos de fallo:
- Es por máquina. Incorporar a un nuevo desarrollador significa volver a explicar el ritual. Tu runner de CI también lo necesita. Tu portátil de reemplazo lo necesita otra vez.
- Es por momento. Las marcas de tiempo solo cubren lo que recordaste sellar. Los commits que olvidaste —normalmente los interesantes, hechos durante un apuro— son los que querrás en una disputa.
- Es evidencia frágil. Un recibo en el directorio home de alguien sin cadena de custodia no es una pista de auditoría.
La vía gestionada traslada todo esto al lado del servidor. Timestamp GIT es una GitHub App que vigila tus repositorios y ancla los hashes de commit automáticamente cada noche. Nunca tocas el protocolo subyacente. La prueba se escribe de vuelta en tu propio repositorio, en una rama dedicada o en un shadow repo, de modo que vive junto al código que describe.
Para contexto sobre por qué un simple git log no es evidencia en primer lugar, consulta Por qué tu Git log no es una prueba. Este artículo es el cómo hacerlo.
Requisitos previos
Antes de empezar, confirma que tienes:
- Una cuenta de GitHub y un repositorio —público o privado— al que quieras poner marca de tiempo.
- Permisos de administrador en ese repositorio o en la organización que lo posee, para poder instalar una GitHub App.
- Para repositorios privados, un plan de pago: Pro Agency (49 $/mes) o Enterprise ZK (199 $/mes). Los repositorios públicos son gratuitos con el plan Open Source.
- Nada más. Sin software local, sin instalación de OpenTimestamps, sin nodo de Bitcoin, sin monedero. Un navegador es toda la cadena de herramientas.
Una nota sobre los permisos, porque es la primera pregunta que hace la gente. El modelo de permisos de GitHub no tiene un alcance de “solo hash de commit”, así que el Modo Estándar requiere acceso de solo lectura al repositorio de origen y acceso de lectura y escritura al repositorio de destino donde se escriben las pruebas. Si incluso el acceso de solo lectura al origen te resulta inaceptable, el Modo Enterprise ZK usa una GitHub Action en su lugar y no requiere ningún acceso de lectura al origen. Más sobre esto en el Paso 6.
Paso a paso: poner marca de tiempo a commits sin la línea de comandos
Paso 1: Instalar la GitHub App de Timestamp GIT
Instala la app desde GitHub Marketplace o desde timestampgit.dev. Durante la instalación se te preguntará qué repositorios puede ver la app, y concederás los dos conjuntos de permisos descritos arriba: solo lectura en tu repositorio de origen, lectura y escritura en el repositorio que recibirá los archivos de prueba.
Si vas a sellar una organización entera, instálala a nivel de organización una vez en lugar de repositorio por repositorio.
Paso 2: Seleccionar los repositorios a monitorizar
Abre el panel en https://timestampgit.dev/repos y elige qué repositorios se monitorizan. Una vez conectado un repositorio, la app detecta los nuevos commits mediante webhooks de GitHub: nada que configurar por commit y nada que recordar.
Puedes comprobar la conexión de inmediato. Los endpoints públicos de estado devuelven JSON, sin necesidad de CLI:
# Last anchored Bitcoin block for a repo
curl -s https://timestampgit.dev/api/statusLast/your-user/your-repo
# How many commits have been stamped so far
curl -s https://timestampgit.dev/api/statusCount/your-user/your-repo
Un repositorio recién creado devolverá legítimamente recuentos de cero hasta que se complete la primera ejecución nocturna.
Paso 3: Hacer commits como siempre
Este es todo el paso de “cambio de flujo de trabajo”, y está vacío. Escribes código, haces git commit, haces push. Timestamp GIT captura el hash de commit que entrega el webhook: no el diff, ni los archivos, ni el código fuente. El servicio nunca ve, copia ni almacena tu código real; solo el SHA que identifica el estado del repositorio.
En la práctica, eso significa que tus desarrolladores no necesitan formación, y tu revisión de seguridad tiene una respuesta corta: el único dato que sale del repositorio es un hash, y un hash es una huella unidireccional.
Paso 4: Dejar que el cron nocturno haga el anclaje
A medianoche, un worker recopila todos los hashes de commit pendientes, los agrupa por repositorio y escribe un archivo de texto manifiesto por repositorio. Construye un árbol de Merkle sobre el lote, crea pruebas de OpenTimestamps contra los calendarios públicos de OTS y ancla la raíz de Merkle en una transacción de Bitcoin.
De ese diseño se derivan dos cosas:
- El batching es barato y privado. Anclar miles de commits individualmente sería absurdo. Una raíz de Merkle por repositorio y día significa que un anclaje cubre todo lo confirmado ese día, y los hashes individuales permanecen ocultos dentro del árbol.
- La entrega de pruebas no es instantánea. El manifiesto y los archivos de recibo
.otsse envían a una rama de timestamps dedicada o a un shadow repo después de la confirmación de Bitcoin, que normalmente tarda unas tres horas. Una ejecución que empieza a medianoche suele terminar de madrugada.
Los hashes de commit esperan en un almacén clave-valor en memoria hasta la ejecución, así que un repositorio que se queda inactivo un día simplemente no genera un nuevo archivo de prueba, no es un error.
Paso 5: Incrustar una insignia de verificación (opcional)
Abre la página Repository Connected de tu repositorio —https://timestampgit.dev/connected/{user}/{repo}— y usa el widget de insignia. Renderiza una vista previa en vivo y te da un fragmento de Markdown para pegar en tu README, de modo que la afirmación de procedencia sea pública y clicable en lugar de un párrafo de aserción.
<!-- Paste the exact snippet generated by the badge widget -->
[](https://timestampgit.dev/status/your-user/your-repo)
Cualquiera que haga clic en la insignia llega a la página de estado pública, que es también adonde querrán ir los auditores.
Paso 6: Autoalojar o pasar a conocimiento cero (opcional)
Existen dos despliegues alternativos para equipos con requisitos más estrictos.
El Modo Enterprise ZK invierte el flujo de datos: una GitHub Action de 12 líneas se ejecuta en tu propia infraestructura y solo envía el hash de commit a la API de Timestamp GIT. Tu código fuente nunca sale de tu entorno, y no se necesita acceso de lectura al repositorio de origen, solo lectura y escritura en el repositorio de destino para la entrega de pruebas.
El autoalojamiento con Docker es para entornos aislados y para cualquiera que quiera la instancia dentro de su propio perímetro. Una configuración rápida de Docker Compose tiene este aspecto:
services:
timestampgit:
image: rue1401/timestampgit:prod
ports:
- "8080:8080"
volumes:
- ./data:/app/data
restart: unless-stopped
valkey:
image: valkey/valkey:8
restart: unless-stopped
docker compose pull
docker compose up -d
docker compose logs -f timestampgit
La aplicación está disponible en http://localhost:8080 tras el arranque. En el primer inicio, un asistente de configuración te guía para conectar tu GitHub App y configurar la instancia. El autoalojamiento requiere una licencia: puedes solicitar una licencia de demostración por tiempo limitado desde la página Docker License con tu nombre, empresa, correo electrónico y número de teléfono opcional, y descargar el archivo de licencia para evaluación.
Cómo confirmar que funcionó
No tomes la insignia como prueba. Confirma en tres niveles, en orden creciente de rigor.
1. La página de estado del repositorio. Visita https://timestampgit.dev/status/{user}/{repo}. Verás la longevidad de las pruebas, la fecha anclada más temprana, la regularidad diaria, los datos del bloque y la transacción de Bitcoin detrás de cada anclaje, y un mapa de calor de calendario que muestra qué días produjeron pruebas. El mapa de calor es la forma más rápida de detectar huecos.
2. Los artefactos de auditoría. Desde la página de estado o la API, obtén el libro de auditoría o un certificado por fecha:
# Full audit ledger as CSV
curl -s -o audit.csv https://timestampgit.dev/api/audit/your-user/your-repo
# PDF certificate for a specific date
curl -s -o certificate.pdf https://timestampgit.dev/api/report/your-user/your-repo/2026-11-03
Estos son los documentos que entregas a un abogado o a un auditor, y el CSV es lo que un equipo de cumplimiento realmente comparará con los registros internos.
3. Verificación criptográfica local. La página de verificación en https://timestampgit.dev/verification/{user}/{repo}/{date} recorre la cadena de Merkle paso a paso, y todos los cálculos ocurren localmente en tu navegador. Nada de lo que verificas se transmite. El archivo de recibo .ots del mismo día está en tu rama de timestamps, y cualquiera puede comprobarlo de forma independiente contra la blockchain de Bitcoin con herramientas estándar de OpenTimestamps: sin cuenta, sin clave de API, sin dependencia de que Timestamp GIT exista.
Ese último punto es el que merece repetirse al departamento legal: la prueba es SHA-256 más datos de bloques de Bitcoin. No hay ningún formato propietario en la ruta de confianza.
Solución de problemas comunes
Las pruebas aún no han aparecido. Mira el reloj antes de mirar cualquier otra cosa. El anclaje requiere una confirmación de Bitcoin, que normalmente tarda unas tres horas tras el lote de medianoche. Si son las 2 de la madrugada, no hay nada mal. Si es la tarde siguiente y la rama sigue vacía, comprueba si el repositorio está realmente en la lista de monitorizados.
Faltan commits en el manifiesto. Casi siempre es un problema de permisos o de webhook. Confirma que la instalación de la GitHub App incluye el repositorio concreto (las instalaciones de organización suelen conceder “repositorios seleccionados” y luego omitir uno), y que la app sigue teniendo una conexión activa. Vuelve a comprobar /api/statusCount/{user}/{repo} tras la siguiente ejecución nocturna.
La página de estado de un repositorio privado no carga. Los repositorios privados añaden un HMAC cifrado a la URL, y ese HMAC es específico de la instancia del servidor. Copia el enlace de insignia autenticado desde la página Repository Connected en lugar de construir una URL a mano: un HMAC truncado o que no coincida con la instancia fallará.
El despliegue de Docker no arranca. Verifica que el archivo Compose nombra exactamente rue1401/timestampgit:prod y valkey/valkey:8, que el puerto 8080 no está ya ocupado, y que ./data existe y es escribible por el contenedor. docker compose logs -f timestampgit normalmente nombrará la dependencia que falla. Si la app arranca pero el asistente de configuración no puede llegar a GitHub, la configuración de OAuth es el lugar donde mirar.
Preguntas frecuentes
¿Necesito instalar algo en las máquinas de los desarrolladores? No. Timestamp GIT es una GitHub App gestionada que se ejecuta en la infraestructura de GitHub y en nuestros servidores. Los desarrolladores solo hacen commits como siempre; no se requieren herramientas de CLI ni software local.
¿Puedo poner marca de tiempo a commits en repositorios privados? Sí. Los repositorios privados son compatibles con los planes de pago (Pro Agency o Enterprise ZK). La app solo lee hashes de commit, nunca tu código fuente, y las pruebas se almacenan en una rama dedicada o en un shadow repo.
¿Cuánto tarda una marca de tiempo en volverse inmutable? Tras el lote nocturno, la raíz de Merkle se ancla en una transacción de Bitcoin. La confirmación suele tardar unas 3 horas, tras lo cual la marca de tiempo es inmutable y verificable.
¿La prueba es independiente del proveedor? Sí. La prueba usa solo SHA-256 y datos de bloques de Bitcoin mediante el protocolo OpenTimestamps. Puedes verificarla sin conexión con herramientas estándar de OpenTimestamps, incluso si Timestamp GIT deja de existir.
¿Qué recibe realmente el equipo de cumplimiento?
Una página de estado pública, un CSV de auditoría descargable que cubre el historial del repositorio, un certificado PDF por fecha y recibos .ots en el repositorio. Para el peso legal de esa evidencia, consulta ¿Es una marca de tiempo en blockchain evidencia legalmente válida?.
Conclusión: instala una vez, prueba para siempre
Poner marca de tiempo a los commits de Git sin la línea de comandos se reduce a una decisión: deja de tratar el timestamping como un ritual por desarrollador y conviértelo en una propiedad del repositorio. Instala la GitHub App, selecciona los repositorios, sigue haciendo commits. El cron nocturno convierte esos commits en pruebas con raíz de Merkle ancladas en Bitcoin, y los recibos vuelven a tu propio repositorio, donde pertenecen.
Empieza con el plan Open Source gratuito en un repositorio público: no cuesta nada y tarda unos cinco minutos. Cuando estés listo para cubrir código privado, pasa a Pro Agency por 49 $/mes, o a Enterprise ZK por 199 $/mes si el modelo de GitHub Action encaja mejor con tu postura de seguridad. En cualquier caso: timestampgit.dev es el único paso de instalación.
Entradas relacionadas
- Alternativas a Timestamp GIT: qué comparar primero
- Las marcas de tiempo de los commits de Git no son a prueba de manipulación: qué sí lo es
- Las mejores herramientas de timestamping de código en 2026