Sincronizar con GitHub

Sí: autorizar la GitHub App, crear o elegir un repositorio, vincular uno o varios proyectos locales, enviar/recibir el JSON del proyecto y —en sync Completa— subir recursos (PDF, imágenes, documentos, audio, etc.) a .hito/attachments/. Desde la UI podés abrir el repo en github.com con Ir al repositorio.

No: no crea issues, pull requests ni tableros de GitHub Projects. Tampoco sube videos ni archivos de más de ~1 MB por el canal de la API (límite del servidor). Hito sigue siendo local-first: el “origen” de verdad es tu workspace; GitHub es un espejo exportable.

En Integraciones → GitHub (o la ruta de conectar), pulsá Conectar con GitHub. Si la cuenta aún no tiene la App instalada, GitHub te pedirá instalarla en una cuenta u organización y elegir repositorios. Si solo autorizás OAuth sin instalación, la conexión no podrá listar repos.

La private key y los secretos de la App viven en el backend (BFF); el navegador solo guarda un vínculo opaco de conexión en este dispositivo. Podés desconectar cuando quieras.

Con la conexión activa, usá Vincular proyectos: elegí un repo existente o creá uno nuevo (privado o público, si la App tiene permiso Administration: write). Luego seleccioná uno o varios proyectos de Hito para vincularlos al mismo repositorio. Cada vínculo se guarda en el dispositivo y apunta a owner/repo.

Al vincular o desde la ficha del proyecto elegís cuánto se envía al repo:

• Ligera: nombre, descripción, estado, fechas, tags y stakeholders.
• Media (por defecto): ligera + tareas, áreas, milestones y sprints (sin comentarios ni adjuntos).
• Completa: todo lo serializable, comentarios y recursos binarios (excepto videos y archivos demasiado grandes).

Los datos del proyecto van a .hito/projects/<id>.json y un manifiesto en .hito/manifest.json. Los recursos, en completa, a .hito/attachments/… (misma estructura que en tu carpeta local).

En Integraciones: Enviar al repo, Recibir del repo o Sincronizar todo (sube todos los vínculos activos). En la ficha del proyecto hay el mismo control si ya está vinculado. Si local y remoto cambiaron desde la última sync, Hito avisa un conflicto y podés mantener la versión local o la del repositorio.

En la lista de proyectos vinculados y en el panel de la ficha del proyecto, el botón Ir al repositorio abre https://github.com/<owner>/<repo> en una pestaña nueva para revisar commits, archivos .hito/ o compartir el enlace.

El contenido que subís queda en tu repositorio de GitHub (con los permisos de esa cuenta). Hito no usa GitHub como multiplayer en tiempo real: la sync ocurre cuando la app está abierta y vos (o un intervalo configurado) la dispara. Para más sobre conexiones y datos locales, ver Ajustes y datos.