Application de bureau

trackica Desktop est disponible pour macOS, Windows et Linux. Il utilise le même compte et les mêmes données d'espace de travail que l'application web, mais il gère automatiquement le daemon sur votre machine et conserve un ensemble d'onglets distinct pour chaque espace de travail.

Desktop et web

Le web est plus pratique pour un coup d'œil rapide ou sur un ordinateur partagé.

Vous pouvez être connecté aux deux en même temps. Tant qu'ils se connectent au même service trackica, les données qu'ils affichent sont partagées.

Installation

Demandez à votre administrateur le programme d’installation approuvé pour votre système d’exploitation et l’architecture de votre processeur :

Après l'installation, connectez-vous avec la même adresse e-mail que sur le web. Une fois connecté, Desktop démarre son propre CLI trackica intégré et détecte les outils de codage IA déjà installés sur la machine.

Onglets de Desktop

Desktop enregistre les onglets par espace de travail. Par exemple, si vous ouvrez trois tâches dans l'espace de travail A puis passez à l'espace de travail B, vous voyez les onglets propres à B ; revenez à A et les trois onglets précédents sont toujours là.

Une même ressource ne s'ouvre qu'une seule fois dans l'espace de travail courant. Les onglets peuvent être réordonnés, épinglés et fermés, et chacun conserve son propre historique de navigation avant/arrière et sa position de défilement. Cliquer sur un lien de l'application pour ce déploiement, ou le coller, l'ouvre directement dans un onglet au lieu de basculer vers le navigateur.

La déconnexion efface tous les onglets enregistrés sur la machine : la personne suivante qui se connecte ne voit jamais les pages laissées par le compte précédent.

Daemon intégré

Après la connexion, Desktop crée un profil CLI dédié au service trackica courant et l'utilise pour démarrer le daemon. Le profil se trouve ici :

~/.trackica/profiles/desktop-<host>/

Il ne lit ni n'écrase jamais le profil par défaut que vous utilisez dans le terminal. Si vous démarrez aussi manuellement un autre daemon, trackica les affiche comme des runtimes distincts.

Vous pouvez consulter l'état et les journaux du runtime dans les paramètres de Desktop. Si un outil n'est pas détecté, vérifiez d'abord qu'il fonctionne dans un terminal ordinaire et qu'il est connecté, puis redémarrez le daemon de Desktop.

Mettre à jour Desktop

La mise à jour automatique est activée par défaut. L'application recherche et télécharge les nouvelles versions en arrière-plan ; une fois une version téléchargée, vous pouvez redémarrer pour l'installer immédiatement ou la laisser s'installer à la prochaine fermeture. Vous pouvez aussi désactiver les vérifications automatiques ou rechercher manuellement de nouvelles versions dans Paramètres → Mises à jour.

Les mises à jour sont distribuées par système d'exploitation et par architecture de processeur :

• Windows arm64 et macOS x64 (Intel) utilisent chacun leur propre flux de mise à jour ;
• toutes les autres architectures utilisent le flux par défaut ;
• l'application sélectionne automatiquement le bon flux de mise à jour — aucun choix manuel n'est nécessaire ;
• sous Linux, la mise à jour automatique ne fonctionne qu'avec .AppImage ; mettez à jour .deb et .rpm en installant un nouveau paquet par-dessus l'ancien ;
• si la mise à jour automatique échoue, demandez à votre administrateur le programme d’installation de remplacement et installez-le par-dessus la version existante.

Se connecter à votre instance privée

Votre administrateur doit fournir l’adresse de l’instance privée avec le programme d’installation. Si elle n’est pas préconfigurée, créez desktop.json dans le répertoire .trackica de votre répertoire personnel avant de vous connecter :

Ce sont les emplacements par défaut ; si votre répertoire personnel a été déplacé ou redirigé, utilisez son chemin réel. Les versions mises à jour ne lisent l’ancien .multica/desktop.json que si le fichier actuel est absent ; les nouvelles configurations doivent se trouver sous .trackica.

{
  "schemaVersion": 1,
  "apiUrl": "https://api.example.com"
}

apiUrl est l'adresse publique du backend ; elle est obligatoire et doit utiliser http ou https. Les deux autres URL peuvent être omises — Desktop les déduit automatiquement :

• wsUrl : remplace le schéma de apiUrl par ws ou wss et ajoute /ws au chemin ;
• appUrl : retire le préfixe api. lorsque l'hôte commence par api. et comporte au moins trois niveaux (api.example.com → example.com) ; sinon, elle reste identique à apiUrl.

En général, apiUrl seul suffit. Ne les définissez explicitement que si la déduction ne correspond pas à votre déploiement ; les trois cas courants :

• l'application web et l'API sont sur des domaines différents ;
• le WebSocket est déployé séparément ;
• l'hôte ne suit pas la convention de retrait du préfixe (les hôtes à deux niveaux comme api.local conservent leur préfixe).

{
  "schemaVersion": 1,
  "apiUrl": "https://api.example.com",
  "appUrl": "https://app.example.com",
  "wsUrl": "wss://ws.example.com/socket"
}

Redémarrez Desktop après l'enregistrement — le fichier n'est lu qu'une fois, au démarrage. Les deux modes d'échec se manifestent différemment, ce qui est le moyen le plus rapide de les distinguer :

• Fichier introuvable (mauvais répertoire, ou nom de fichier qui n'est pas exactement desktop.json) — Desktop utilise la configuration par défaut intégrée au paquet et n'affiche aucune erreur. Donc, si Desktop indique toujours l’adresse intégrée au paquet sans aucune erreur de configuration, le fichier ne se trouve pas là où Desktop le cherche.
• Fichier trouvé mais invalide (JSON, version ou URL) — Desktop affiche une erreur de configuration et ne se rabat pas sur la configuration intégrée.

Supprimez le fichier et redémarrez pour revenir à la configuration par défaut intégrée au paquet.

Windows : vérifier le nom et l'encodage du fichier

Deux comportements par défaut des éditeurs Windows produisent silencieusement un fichier que Desktop ne peut pas utiliser :

• Le Bloc-notes ajoute .txt. Enregistrer sous desktop.json peut produire desktop.json.txt, que Desktop considère comme introuvable. Activez l'affichage des extensions de noms de fichiers dans l'Explorateur de fichiers, ou choisissez Tous les fichiers dans la boîte de dialogue d'enregistrement. Pour voir le vrai nom du fichier, exécutez Get-ChildItem "$env:USERPROFILE\.trackica" -Filter "desktop.json*" dans PowerShell — la colonne Name doit indiquer exactement desktop.json.
• La redirection PowerShell écrit en UTF-16 ou avec un BOM. > desktop.json et Out-File peuvent produire un encodage impossible à analyser, qui se traduit par une erreur de configuration.

Pour éviter ces deux problèmes, créez le fichier depuis PowerShell en une seule étape :

$dir = "$env:USERPROFILE\.trackica"
New-Item -ItemType Directory -Force $dir | Out-Null
$json = @'
{
  "schemaVersion": 1,
  "apiUrl": "https://api.example.com"
}
'@
[System.IO.File]::WriteAllText("$dir\desktop.json", $json)

Windows Defender signale trackica comme un virus

Symptôme : Sécurité Windows signale une menace telle que Trojan:Script/Wacatac.B!ml et met en quarantaine un fichier de l'installation de Desktop. L'élément concerné est normalement le CLI intégré, et non l'exécutable de l'application :

C:\Users\<you>\AppData\Local\Programs\trackica\resources\app.asar.unpacked\resources\bin\trackica.exe

Il peut s’agir d’un faux positif. Le suffixe !ml indique un verdict des heuristiques d’apprentissage automatique de Defender, et non d’une signature de logiciel malveillant. Les builds Windows de trackica ne sont pas encore signées avec Authenticode ; un binaire non signé qui lance des processus en arrière-plan et ouvre des connexions réseau peut être jugé suspect. Vérifiez le programme d’installation et sa somme de contrôle avec votre administrateur avant de l’autoriser.

Vérifiez par vous-même — chaque release GitHub publie un fichier checksums.txt couvrant toutes les archives du CLI :

Get-FileHash .\trackica-cli-<version>-windows-amd64.zip -Algorithm SHA256

Comparez l'empreinte obtenue avec la ligne correspondante de checksums.txt dans la dernière release.

Comment corriger :

1. Restaurez le fichier mis en quarantaine — Sécurité Windows → Protection contre les virus et menaces → Historique de protection → sélectionnez l'élément trackica → Actions → Restaurer.

2. Ajoutez une exclusion pour qu'il ne soit plus mis en quarantaine — Protection contre les virus et menaces → Gérer les paramètres → Exclusions → Ajouter une exclusion → Dossier, et ajoutez les deux dossiers suivants :

   • %LOCALAPPDATA%\Programs\trackica
   • %APPDATA%\trackica

   Les deux chemins sont nécessaires : lorsque le CLI intégré disparaît, Desktop télécharge un remplaçant dans %APPDATA%\trackica\bin ; exclure uniquement le dossier d'installation vous enferme donc dans une boucle où le remplaçant est lui aussi mis en quarantaine.

3. Signalez le faux positif à Microsoft sur Microsoft Security Intelligence — soumettre un fichier, en choisissant Software developer et Incorrectly detected as malware. C'est ce qui permet de retirer la détection pour tous les utilisateurs, généralement en quelques jours.

Étapes suivantes

• Démarrage rapide — le parcours de première connexion.
• Daemon et runtimes — le fonctionnement du daemon intégré.
• Dépannage — diagnostiquer les problèmes de connexion.