Linear

Conectar

Pulse «Conectar» junto a Linear, en «Nube», en el inicio de Exporter. Inicie sesión con Apple; su navegador abre la página de Linear, donde pulsa «Authorize». Exporter solo pide a Linear permiso para leer. De vuelta en Exporter, elija dónde van los archivos y pulse «Usar esta carpeta».

El token de Linear se queda sellado en el servidor de Exporter. Su Mac inicia sesión en ese servidor y nunca lo guarda.

Elegir elementos

La página de selección lista cada incidencia, proyecto y documento, todos marcados, con tres pestañas: Incidencias, Proyectos y Documentos. Desmarque lo que no quiera; su archivo se queda fuera.

Dónde van los archivos

Una carpeta directamente en su carpeta de inicio, como ~/Documents, recibe una carpeta linear-export dentro; una más profunda se usa tal cual.

• Incidencias: una carpeta por equipo, un archivo por incidencia, con el nombre de su id y su título: Northwind/NW-142 Invite flow.md
• Proyectos: Projects/Q4 launch.md
• Documentos: Documents/<project or team>/<title>.md

El archivo

El front matter de una incidencia lleva id, team, state, priority, assignee, creator, labels, project, cycle, parent, estimate, due y las fechas, con source_url que la abre en Linear. Después el título, la descripción y cada comentario, del más antiguo al más reciente. Un proyecto lleva su estado, responsable, equipos y fechas; un documento, su proyecto, equipo y autor. Las horas están en UTC.

Sincronización

Linear avisa al servidor de Exporter de cada cambio. El servidor reescribe el archivo al momento y avisa a su Mac, que lo descarga: un cambio llega en segundos, un minuto como mucho. Una incidencia renombrada mueve su archivo; una que archive, tire o elimine lo pierde. «Sincronizar ahora» pregunta primero al servidor; «Resincronización completa» vuelve a escribir cada archivo.

Exporter Cloud

Los primeros 7 días desde su primera conexión son gratis. Después, Exporter Cloud es una suscripción en el App Store: Linear solo, o All Cloud para cada fuente en la nube que añadamos, al mes o al año. Cuando un plan termina, la sincronización se detiene y sus archivos se quedan. Treinta días después, el servidor elimina sus copias y el token.

Cuenta

Ajustes › Cuenta muestra el correo con el que inició sesión. «Cerrar sesión» conserva la conexión para cuando vuelva a entrar. «Eliminar cuenta…» desconecta cada espacio de trabajo y elimina todo lo que el servidor guarda de usted. Los archivos de su Mac se quedan.

Línea de comandos

exporter export --source linear --dest <folder> escribe los archivos del espacio de trabajo en una carpeta autorizada en la tarjeta Línea de comandos. Vea la línea de comandos.

Problemas y soluciones

• La tarjeta dice «Conectar de nuevo…»: Linear ya no acepta la conexión, a menudo porque se quitó la app en los ajustes de Linear. Púlselo y autorice de nuevo.
• La tarjeta dice «Iniciar sesión…»: la sesión terminó. Inicie sesión con la misma cuenta de Apple y la sincronización continúa.
• Falta una incidencia: compruebe que está marcada y pulse «Sincronizar ahora». Las incidencias archivadas no se exportan.