Consulta pull requests y GitHub Actions en Mac

Qué puedes consultar desde el Mac

MakerNotch muestra las pull requests abiertas y las ejecuciones recientes de GitHub Actions del repositorio conectado al proyecto seleccionado. Una consulta rápida permite decidir si seguir trabajando, revisar una pull request o investigar un fallo.

Por ejemplo, después de subir un cambio a Orbit, abre GitHub en MakerNotch y comprueba la última ejecución. Si ha fallado, abre el workflow en GitHub para leer los logs. Si ha pasado, comprueba el despliegue de Vercel antes de dar por hecho que el cambio llegó a producción. Orbit es un proyecto de ejemplo, no un resultado de un cliente.

Elige entre una bandeja de revisiones y un panel por proyecto

Empieza por la consulta que repites con más frecuencia. Si necesitas sobre todo una cola de pull requests pendientes de revisión entre repositorios, compara una app especializada. PullBar describe vistas configurables de pull requests y GitHubBar se centra en solicitudes y estados de revisión. Son descripciones de sus productos, no una comparativa basada en pruebas de uso.

MakerNotch encaja cuando seleccionas un producto, compruebas su repositorio y CI y después consultas sus conexiones de despliegues y pagos en el mismo panel. Conecta un repositorio de GitHub por proyecto de MakerNotch; no reúne todos los repositorios en una bandeja de revisiones ni permite revisar el código dentro del panel.

Tu siguiente pregunta	Dónde continuar
¿La pull request requiere atención?	Consulta el estado y abre GitHub para revisar el diff y la conversación.
¿El cambio llegó a Production o solo a Preview?	Comprueba los despliegues de Vercel.
¿Estoy consultando las cuentas del producto correcto?	Separa las conexiones por proyecto.

Mira el recorrido de la app para comprobar si esta secuencia encaja contigo antes de comprar.

Conecta un repositorio existente de GitHub

Necesitas MakerNotch activado en macOS 14 o posterior y acceso al repositorio. Si aún no tienes la app, sigue la guía de instalación.

1. Selecciona el proyecto de MakerNotch y abre Ajustes → GitHub.
2. Para un repositorio público, introduce propietario/repositorio. El token es opcional en este caso.
3. Para uno privado, crea un token personal de acceso detallado en GitHub. Elige el propietario de los recursos y limita el acceso al repositorio necesario. Concede permisos de lectura a Metadata, Pull requests y Actions.
4. Pega el token en MakerNotch. Carga la lista de repositorios y selecciona uno, o escribe su nombre.
5. Verifica y conecta. Revisa cada comprobación y abre la vista de GitHub para confirmar el repositorio y los datos recibidos.

Una organización puede exigir aprobar el token antes de permitir el acceso. Consulta la documentación de tokens de GitHub si la autorización está pendiente o restringida. Cuando caduque el token, sustitúyelo en los ajustes de la conexión.

Para el mapa opcional de actividad de commits de un repositorio privado, activa también Contents: read. GitHub exige ese permiso para listar commits. MakerNotch trata ese historial como opcional: las pull requests y el CI pueden cargar aunque no haya acceso a los commits. Un mapa vacío, por sí solo, no demuestra que no se hayan hecho commits.

Cada token de acceso detallado pertenece a un único propietario de recursos. Si tus proyectos pertenecen a distintos propietarios u organizaciones de GitHub, configura cada proyecto de MakerNotch con un token para el propietario adecuado. El token no concede más acceso del que ya tiene quien lo crea.

Estos pasos sirven para leer un repositorio existente. No necesitas permisos de creación para monitorizarlo. La acción opcional de crear un repositorio es independiente.

Frecuencia de actualización y significado del estado

La actualización automática viene desactivada. Puedes consultar manualmente o activarla en ajustes. Al activarla, GitHub se comprueba aproximadamente cada minuto con el panel abierto y cada cinco minutos cerrado. El acceso público sin token utiliza unos tres minutos con el panel abierto.

Los errores, el reposo del Mac y los límites de GitHub pueden alargar esos intervalos. Un workflow correcto confirma que esa ejecución pasó; no demuestra que la aplicación desplegada funcione correctamente.

Resuelve problemas con las pull requests o el CI

• No se encuentra el repositorio: revisa el nombre, los repositorios autorizados en el token y la aprobación de la organización.
• Aparecen pull requests, pero no CI: comprueba Actions: read y el aviso de la conexión. MakerNotch puede conservar las pull requests aunque CI no esté disponible.
• El mapa de commits de un repositorio privado está vacío: comprueba Contents: read y compara con la rama predeterminada en GitHub. Es independiente de Actions: read.
• No hay historial: confirma que el repositorio tenga ejecuciones de GitHub Actions. Una lista vacía no equivale a una ejecución fallida.
• Los datos son antiguos: comprueba la actualización automática y el error de conexión. Si hay un límite de peticiones, espera antes de reintentar.

La documentación de ejecuciones de GitHub Actions detalla el permiso de lectura utilizado.

Preguntas frecuentes

¿Puedo usar distintas cuentas de GitHub por proyecto?

Sí. Configura cada proyecto de MakerNotch con un token que pueda leer su repositorio. Consulta cómo separar las conexiones por proyecto. Al abrir GitHub en el navegador se sigue utilizando la cuenta iniciada en ese navegador.

¿Dónde se guarda el token?

En el Llavero de macOS para ese proyecto. Las peticiones van del Mac a GitHub. La política de privacidad explica por separado la app, la licencia y la web.

¿Puedo revisar o fusionar una pull request desde aquí?

La app permite detectar qué necesita atención. Para leer las diferencias, comentar o fusionar, abre GitHub.