01 Añade tu primer repositorio
Prepara un clon local.
Clona el repositorio con tu herramienta Git habitual y comprueba que puedes acceder al remoto. Las compilaciones de desarrollo usan el Git instalado. La versión aislada de la tienda incluye Git y solicita acceso al repositorio mediante el selector de carpetas del sistema.
Abre la barra de menús y elige «Añadir monitor».
Selecciona el repositorio local y marca una o varias ramas remotas. Cada rama sigue los cambios de forma independiente; las de un mismo repositorio comparten una tarjeta. Puedes editar el repositorio después para añadir o quitar ramas.
Espera a la primera comprobación correcta.
La primera comprobación establece una referencia sin avisar de los commits existentes. Los cambios posteriores generan una notificación y un sonido por rama y lote.
02 Consulta quién cambió qué
Las tarjetas contraídas muestran el último commit de cada rama, con su autor y fecha. Despliega un repositorio para combinar el historial de todas las ramas seguidas. Los commits compartidos aparecen una sola vez, con las etiquetas de sus ramas, ordenados del más reciente al más antiguo según la fecha del commit.
Se muestran 10 entradas de forma predeterminada. En Ajustes puedes elegir entre 5 y 20, contadas después de combinar, eliminar duplicados y filtrar autores. Los mensajes largos de commit se pueden desplazar dentro del historial.
Usa el menú de la tarjeta para fijar, editar, pausar, reanudar o confirmar la eliminación. La barra de menús distingue entre reposo, comprobación y actualizaciones sin leer. Al abrir el panel, todas las actualizaciones se marcan como leídas; al cerrarlo, el seguimiento sigue activo.
Las fechas proceden de los commits de Git, no del momento del envío o de la detección. Git Knock comprueba los cambios periódicamente; no recibe eventos de envío instantáneos.
04 Elige cómo recibir los avisos
Abre Ajustes con el botón de engranaje. Todos los repositorios comparten el intervalo de comprobación: 1 minuto de forma predeterminada, ajustable a minutos enteros entre 1 y 60.
Elige un sonido
Elige entre 14 sonidos del sistema macOS o desactiva los sonidos automáticos. Para importar un sonido propio, elige un archivo MP3, WAV o AIFF de más de cero y hasta 15 segundos. Escúchalo con el botón de reproducción.
La app guarda una copia local. Si el archivo no es válido o la importación falla, se mantiene la selección anterior. Si un sonido personalizado no se puede leer o reproducir, se usa el predeterminado. Utiliza grabaciones o audio que tengas permiso para usar; no se incluyen clips de voz de videojuegos.
Idioma y barra de menús
Sigue el idioma del sistema o elige chino, inglés, coreano, japonés, español, portugués, francés o alemán. Si el idioma del sistema no es compatible, se utiliza el inglés. Los nombres de repositorio y el texto de los commits conservan su idioma original.
Activa la visualización del último commit en la barra de menús para tener dos líneas de contexto. Elige por separado repositorio, rama, autor y hora, y muestra el último segmento o el nombre completo de la rama. Desactiva todos los campos para mostrar solo el icono; la ayuda emergente conserva los detalles completos.
Inicio de sesión y salida
El inicio automático de la app al iniciar sesión puede requerir aprobación en Ajustes del Sistema de macOS. Cerrar el panel lo oculta. «Salir de Git Knock», al final de Ajustes, detiene el seguimiento y cierra la app.
05 ¿No llega el aviso?
Prueba una notificación y un sonido.
Envía una notificación de prueba desde Ajustes. Comprueba los permisos de notificaciones de macOS, el estilo de aviso y el modo de concentración. Una prueba no representa un commit ni reproduce el sonido de actualización. Prueba el sonido por separado y comprueba el volumen y los dispositivos de salida.
Acceso SSH en la versión de la tienda
Para los remotos SSH, autoriza la carpeta de configuración SSH existente, normalmente .ssh, en Ajustes → Configuración SSH. Debe contener un archivo no vacío llamado known_hosts. El acceso es de solo lectura: la app no copia claves privadas ni confía automáticamente en nuevos servidores. Los remotos HTTPS y locales no necesitan este permiso SSH. Las claves externas, los proxies y los asistentes de credenciales deben seguir siendo accesibles dentro del entorno aislado.
Comprueba el seguimiento y la conexión remota.
Confirma que el seguimiento está activo y que se ha establecido su referencia. Espera un intervalo de comprobación. Si falla la conexión remota, ejecuta git ls-remote --heads origin en el mismo repositorio; sustituye origin si hace falta. Los problemas de SSH, proxy y credenciales pueden afectar tanto a la búsqueda de ramas como a las comprobaciones.
Consulta Ayuda para obtener ayuda e indica la versión de la app, la de macOS y unos breves pasos para reproducir el problema.
06 ¿Qué ocurre con el repositorio?
Git Knock descarga los destinos seleccionados mediante fetch a referencias Git propias de la app. No ejecuta pull, cambia de rama, fusiona, modifica archivos de trabajo ni actualiza referencias habituales de seguimiento remoto o etiquetas. Tú decides cuándo integrar el código.
Informa de cambios en el código, no de tareas completadas, pruebas o despliegues. El historial enviado y eliminado por completo entre comprobaciones puede pasar inadvertido.