Linear

Connexion

Appuyez sur « Connecter » à côté de Linear, sous « Cloud », sur l’accueil d’Exporter. Connectez-vous avec Apple ; votre navigateur ouvre la page de Linear, où vous appuyez sur « Authorize ». Exporter demande seulement à Linear de lire. De retour dans Exporter, choisissez où vont les fichiers et appuyez sur « Utiliser ce dossier ».

Le jeton de Linear reste scellé sur le serveur d’Exporter. Votre Mac se connecte à ce serveur et ne le détient jamais.

Choisir les éléments

La page de choix liste chaque ticket, projet et document, tous cochés, avec trois onglets : Tickets, Projets et Documents. Décochez ce que vous ne voulez pas ; son fichier reste dehors.

Où vont les fichiers

Un dossier directement dans votre dossier personnel, comme ~/Documents, reçoit un dossier linear-export ; un dossier plus profond est utilisé tel quel.

• Tickets : un dossier par équipe, un fichier par ticket, nommé d’après son identifiant et son titre : Northwind/NW-142 Invite flow.md
• Projets : Projects/Q4 launch.md
• Documents : Documents/<project or team>/<title>.md

Le fichier

Le front matter d’un ticket porte id, team, state, priority, assignee, creator, labels, project, cycle, parent, estimate, due et les dates, avec source_url qui l’ouvre dans Linear. Puis le titre, la description et chaque commentaire, du plus ancien au plus récent. Un projet porte son état, son responsable, ses équipes et ses dates ; un document, son projet, son équipe et son auteur. Les heures sont en UTC.

Synchronisation

Linear signale chaque modification au serveur d’Exporter. Le serveur réécrit le fichier aussitôt et prévient votre Mac, qui le télécharge : une modification arrive en quelques secondes, une minute au plus. Un ticket renommé déplace son fichier ; un ticket archivé, jeté ou supprimé le perd. « Synchroniser » interroge d’abord le serveur ; « Resynchronisation complète » réécrit chaque fichier.

Exporter Cloud

Les 7 premiers jours dès votre première connexion sont gratuits. Ensuite, Exporter Cloud est un abonnement dans l’App Store : Linear seul, ou All Cloud pour chaque source cloud ajoutée, au mois ou à l’année. Quand un forfait se termine, la synchronisation s’arrête et vos fichiers restent. Trente jours plus tard, le serveur supprime ses copies et le jeton.

Compte

Réglages › Compte montre l’adresse e-mail avec laquelle vous vous êtes connecté. « Se déconnecter » garde la connexion pour la prochaine fois. « Supprimer le compte… » déconnecte chaque espace de travail et supprime tout ce que le serveur conserve pour vous. Les fichiers sur votre Mac restent.

Ligne de commande

exporter export --source linear --dest <folder> écrit les fichiers de l’espace de travail dans un dossier autorisé sur la carte Ligne de commande. Voir la ligne de commande.

Problèmes et solutions

• La carte affiche « Reconnecter… » : Linear n’accepte plus la connexion, souvent parce que l’app a été retirée dans les réglages de Linear. Appuyez dessus et autorisez de nouveau.
• La carte affiche « Se connecter… » : la session a pris fin. Connectez-vous avec le même compte Apple et la synchronisation reprend.
• Un ticket manque : vérifiez qu’il est coché, puis appuyez sur « Synchroniser ». Les tickets archivés ne sont pas exportés.