Aller au contenu

Icône de la zone de notification

L'icône de la zone de notification est une petite icône placée dans la zone de notification de votre bureau (Windows), la barre des menus (macOS) ou la barre d'état système (Linux). Elle répond en un coup d'œil à trois questions : Tegvia me protège-t-il, vient-il de bloquer quelque chose, et comment atteindre la console web. Elle n'ouvre aucune fenêtre propre. Lancer l'icône lance Tegvia : si le service en arrière-plan est installé mais arrêté, l'icône le démarre (une seule fois, sans nouvelle tentative). Quitter l'icône arrête Tegvia, après confirmation (voir Le menu).

L'icône ne parle qu'au proxy de votre machine (127.0.0.1) et, pour le démarrer ou l'arrêter, au service installé sur cette machine.

Où la trouver

  • Windows 10 et 11 : dans la zone de notification, à droite de la barre des tâches. Windows range souvent les nouvelles icônes derrière la flèche ^ (« Afficher les icônes cachées ») : cliquez dessus et faites glisser l'icône Tegvia sur la barre des tâches pour la garder visible. Au clavier, appuyez sur Win+B puis sur les flèches.
  • macOS 11 ou plus récent : dans la barre des menus, à droite. Il n'y a pas d'icône dans le Dock.
  • Linux (x86_64, aarch64, riscv64) : dans la barre d'état système de votre bureau (KDE Plasma, XFCE, Cinnamon, MATE et les autres bureaux qui affichent les icônes StatusNotifier). GNOME n'affiche aucune barre d'état par défaut : installez et activez l'extension AppIndicator and KStatusNotifierItem Support (gnome-shell-extension-appindicator), puis fermez et rouvrez votre session. Sans elle, l'icône n'apparaît pas (voir Dépannage).

Les six états

L'état est porté par la forme du badge en bas à droite de l'icône, pas seulement par la couleur (la couleur n'est qu'un complément sous Windows et Linux ; sous macOS, l'icône est monochrome et le système la teinte). Survolez l'icône pour lire l'état en toutes lettres, ainsi que la version et le port.

État Forme du badge Signification Info-bulle (première ligne)
Active cercle avec une coche La protection est active. Tegvia : protection active
En pause carré avec deux barres La protection a été désactivée. Les requêtes sont relayées sans inspection. Tegvia : protection désactivée
À vérifier triangle avec un point d'exclamation Le proxy tourne mais quelque chose demande votre attention : les réglages de Claude Code ne peuvent pas être modifiés, ou Claude Code ne passe pas par Tegvia. L'info-bulle donne la cause. Tegvia : à vérifier, cause
Arrêté cercle vide avec une croix ; le symbole Tegvia est entier mais estompé Le proxy ne répond pas. Tegvia : le proxy ne répond pas
Démarrage arc ouvert (trois quarts de cercle) Attente de la première réponse, jusqu'à 15 secondes après le lancement de l'icône (plus longtemps pendant que l'icône démarre le service). Tegvia : démarrage…
Erreur losange avec une barre horizontale Tegvia n'a pas pu démarrer : la commande de démarrage du service a échoué. Tegvia : impossible de démarrer (code N)

La seconde ligne de l'info-bulle est toujours Tegvia <version> · port <port>. L'icône n'affiche « Arrêté » qu'après deux vérifications ratées d'affilée (environ 10 secondes) : une brève interruption ne la fait donc pas clignoter. Les textes suivent la langue du proxy (français ou anglais) ; si le proxy ne répond pas, la langue de votre système est utilisée.

L'état Erreur apparaît quand le démarrage que l'icône effectue à son lancement échoue, ou quand Service > Démarrer échoue alors que l'icône affiche déjà Erreur. Un Service > Démarrer qui échoue depuis un autre état (par exemple Arrêté) affiche seulement la notification d'échec habituelle, et l'icône reste Arrêtée. L'info-bulle donne le code de sortie de la commande de démarrage (le plus souvent 1 ; ne comptez pas sur une valeur précise) et une notification unique « L'action sur le service a échoué » affiche ce code. Le menu se comporte comme à l'état Arrêté, mais Service > Démarrer reste utilisable. L'état disparaît dès que Tegvia répond. Pour trouver la cause, consultez tray.log et proxy.stderr.log (voir Dépannage).

Limite sous Linux et macOS : si le gestionnaire de services accepte le démarrage mais que Tegvia échoue ensuite (par exemple parce que le port est déjà utilisé), l'icône affiche Arrêté et non Erreur, sans notification d'échec. Erreur n'apparaît alors que si la commande de démarrage elle-même échoue. Consultez les journaux, corrigez la cause, puis utilisez Service > Démarrer. Sous Windows, un port occupé donne bien Erreur ; la tâche planifiée est de plus relancée jusqu'à 3 fois (voir Service).

Version expirée

Quand la version a une date de fin (voir Expiration de la version d'évaluation) :

  • Pendant les 30 derniers jours, le menu affiche une ligne grisée après la ligne d'état (« Évaluation : expire le date (dans N jours) », « (demain) », ou « Évaluation : expire aujourd’hui (date) »), et une notification par jour a pour titre « L’évaluation de Tegvia se termine dans N jours » (ou « demain », « aujourd’hui ») avec la date et l'adresse de contact (hello@tegvia.tech). Cette notification suit l'option Notifications : désactivée, rien n'est envoyé.
  • Une fois expirée, les états « Arrêté », « Démarrage » et « Erreur » sont remplacés par Version expirée (infobulle « Tegvia : version expirée », même pastille que Arrêté). Service > Démarrer et Redémarrer sont désactivés, et l'icône ne démarre plus le service au lancement. Documentation ouvre la documentation du dossier de l'archive (docs/index.html), puisque le proxy qui la sert d'habitude ne tourne pas ; l'entrée est grisée si ce fichier manque. Obtenez une nouvelle version auprès de hello@tegvia.tech.

Le menu

Une action du menu prend effet en une seconde environ.

Ouvrez le menu par un clic droit (Windows) ou un clic (macOS et Linux). Sous Windows, un clic gauche ouvre directement la console ; sous Linux, selon votre bureau, un clic peut aussi ouvrir la console.

  1. Ligne d'état : la même phrase que l'info-bulle. Non cliquable.
  2. Ouvrir la console : ouvre http://127.0.0.1:<port>/tegvia/ui/ dans votre navigateur.
  3. Protection (cochée quand elle est active) : la décocher ouvre un sous-menu avec une seule entrée, Désactiver la protection, qui sert de confirmation. Réactiver la protection se fait en un clic. C'est la même chose que l'interrupteur des Réglages. L'entrée est grisée quand l'icône est Arrêté ou Démarrage, et quand les réglages de Claude Code ne peuvent pas être modifiés.
  4. Dernières alertes : jusqu'à cinq lignes HH:MM · module (heure locale, la plus récente d'abord) pour les dernières requêtes et appels d'outils bloqués. Cliquer sur une ligne ouvre la console. S'il n'y a rien à montrer, la ligne indique « Aucune alerte ». Avec un ancien proxy qui ne propose pas les alertes, elle indique « Dernières alertes (proxy trop ancien) » et est grisée.
  5. Notifications (sous-menu) : Notifications (activées ou non) et Notifier aussi les avertissements (voir ci-dessous). Vos choix sont mémorisés.
  6. Service (sous-menu Démarrer, Arrêter, Redémarrer) : affiché seulement si le service en arrière-plan est installé sur cette machine. Les trois entrées sont grisées pendant l'exécution d'une commande (jusqu'à 30 secondes) et les clics supplémentaires sont ignorés. À la fin, une notification indique « Service démarré », « Service arrêté » ou « Service redémarré » ; si la commande échoue ou dépasse 30 secondes, la notification donne uniquement le code de sortie.
  7. Documentation : ouvre la documentation servie par le proxy.
  8. À propos : la version de l'icône et, si elle diffère, celle du proxy.
  9. Quitter Tegvia : ferme l'icône et arrête Tegvia.
    • Quand le service en arrière-plan est installé et actif, l'entrée ouvre un sous-menu de confirmation : une ligne grisée (« Tegvia ne vous protégera plus tant que vous ne l’aurez pas relancé. »), Arrêter Tegvia et quitter et Annuler. Arrêter Tegvia et quitter arrête le service (le proxy, le port et la redirection de Claude Code) puis ferme l'icône, au plus 30 secondes après ; si l'arrêt échoue, l'icône se ferme quand même et le code n'est écrit que dans tray.log. Annuler ne change rien.
    • Dans les autres cas (service non installé, arrêté ou d'état inconnu, Tegvia lancé à la main ou par le lanceur autonome), l'entrée est simple : un clic ferme l'icône, sans confirmation, et rien n'est arrêté.

Quand l'icône est Arrêté, Erreur ou Démarrage, Ouvrir la console, Protection, Dernières alertes et Documentation sont grisés. Rien dans le menu ne démarre le proxy, sauf Service > Démarrer quand le service est installé.

Notifications

L'icône envoie une notification native du système :

  • quand Tegvia bloque une requête (titre « Tegvia a bloqué une requête ») ou un appel d'outil (titre « Tegvia a bloqué un appel d'outil »). Le texte se limite au nom du module et à l'heure, par exemple secret_scan · 14:32 ;
  • une seule fois quand la protection est désactivée (« La protection Tegvia est désactivée »), quand le proxy ne répond plus (« Le proxy Tegvia ne répond pas ») et quand la protection est rétablie (« La protection Tegvia est de nouveau active ») ;
  • quand une commande du service réussit (« Service démarré », « Service arrêté », « Service redémarré ») ;
  • quand une action du menu échoue (« Impossible de modifier la protection », « L'action sur le service a échoué »), avec un code d'erreur seulement.

Une notification n'affiche jamais le motif d'un blocage, le contenu de la requête, un chemin de fichier, une commande ni un secret. Pour le détail, ouvrez la console (sous Windows et Linux, un clic sur la notification l'ouvre).

Lors d'une rafale de blocages, les trois premiers dans une fenêtre de 10 secondes sont affichés un par un, et les suivants sont regroupés dans une seule notification (« N autres requêtes bloquées »).

Les avertissements (alertes sous le niveau de blocage) sont désactivés par défaut. Cochez Notifications > Notifier aussi les avertissements pour les recevoir aussi. Décochez Notifications pour n'en recevoir aucune ; l'entrée des avertissements est alors grisée. L'icône et le menu continuent de se mettre à jour dans tous les cas. Le mode Ne pas déranger de votre système (Concentration sous macOS, Assistant de concentration sous Windows, « ne pas déranger » du bureau) s'applique comme pour toute notification.

Lancer l'icône

install (service en arrière-plan) configure aussi le lancement de l'icône à l'ouverture de session et la lance tout de suite. Ajoutez --no-tray pour n'installer que le service :

./install.sh --no-tray            # Linux, macOS
install.cmd --no-tray             # Windows
Système Entrée de lancement automatique
Linux ~/.config/autostart/io.tegvia.tray.desktop
macOS LaunchAgent ~/Library/LaunchAgents/io.tegvia.tray.plist (sessions graphiques seulement)
Windows la valeur Tegvia sous HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run

Sur tous les systèmes, un problème avec l'icône ne fait jamais échouer install : il affiche la raison et le service est installé quand même. Quand l'icône ne peut pas fonctionner sur cette machine (par exemple GNOME sans l'extension AppIndicator), install n'écrit aucune entrée de lancement automatique et affiche un seul message donnant la raison et les étapes pour activer l'extension : relancez install une fois le problème réglé. install --no-tray ne retire pas une entrée déjà existante (voir Dépannage). Tegvia n'écrase jamais une entrée qu'il n'a pas créée. uninstall retire l'entrée de lancement automatique et ferme l'icône.

Pour lancer l'icône à la main, par exemple sans le service ou après l'avoir quittée :

Système Commande
Linux, macOS sh launch/tegvia-tray.sh
Windows launch\tegvia-tray.cmd

Une icône lancée à l'ouverture de session, ou par install, utilise le port installé. Une icône lancée à la main utilise 8736, sauf si TEGVIA_PORT vaut le même port dans ce terminal.

La lancer deux fois est sans danger : le second lancement affiche « L'icône Tegvia est déjà lancée. » (« Tegvia icon is already running. » si votre système est en anglais) et se termine (Linux et macOS). Sous Windows, le lanceur démarre l'icône en arrière-plan et n'affiche rien : le message et tout problème de démarrage ne sont que dans %USERPROFILE%\.tegvia\state\tray.log.

Lancer l'icône démarre aussi Tegvia quand le service est installé et arrêté (une seule tentative, l'icône affiche Démarrage, sans notification en cas de succès). Si le service tourne déjà, est absent ou d'état inconnu, le lancement ne démarre rien.

L'icône n'est pas relancée automatiquement. Après Quitter Tegvia, Tegvia reste arrêté jusqu'au prochain lancement de l'icône ou à la prochaine ouverture de session. Pour le relancer tout de suite, lancez l'icône à la main (sh launch/tegvia-tray.sh ou launch\tegvia-tray.cmd).

Linux et macOS : dépendances

Sous Linux et macOS, l'icône a besoin d'un petit jeu supplémentaire de bibliothèques Python (installé dans le dossier .deps/ de Tegvia au premier lancement, comme celui du proxy, à partir du fichier verrouillé par empreintes requirements-tray.txt). Elle les installe toute seule (accès réseau à PyPI nécessaire). Windows n'a besoin de rien de plus.

WSL

WSL n'a pas de zone de notification. Lancez l'icône côté Windows, avec launch\tegvia-tray.cmd : elle joint le proxy qui tourne dans WSL par localhost. Sous WSL même, install n'installe pas l'icône et le dit, et l'entrée Service n'est pas affichée (Windows ne peut pas piloter un service WSL).

Systèmes pris en charge

Système Pris en charge
Linux x86_64, aarch64, riscv64, dans une session graphique (X11 ou Wayland) avec un hôte de barre d'état
macOS 11 ou plus récent (Intel et Apple silicon)
Windows 10 et 11 (x64 et ARM64)

Ailleurs, l'icône affiche la raison et se termine avec le code 3, sans aucune boîte de dialogue. Cela arrive aussi sous WSL, sans session graphique, sous GNOME sans l'extension AppIndicator, ou quand ses dépendances ne peuvent pas être installées. Rien d'autre n'est touché : le proxy et la protection ne dépendent pas de l'icône. La raison s'affiche à l'écran quand vous la lancez à la main sous Linux et macOS, et dans ~/.tegvia/state/tray.log (sous Windows, uniquement là).

Limites

  • Notifications macOS : elles apparaissent sous le nom Script Editor (c'est ainsi qu'elles sont envoyées) et ne sont pas cliquables pour ouvrir la console : utilisez le menu.
  • GNOME a besoin de l'extension AppIndicator (voir ci-dessus) ; sans elle, pas d'icône.
  • Le menu peut se rafraîchir en retard. Sur certains bureaux, un menu ouvert ne montre les changements qu'à sa prochaine ouverture.
  • Pas de relance automatique de l'icône : utilisez install, ou le lanceur manuel.
  • Sans icône visible (WSL, Linux sans session graphique, GNOME sans AppIndicator) : le service démarre quand même à l'ouverture de session, mais rien ne le démarre au lancement de l'icône et aucune entrée ne le quitte ; arrêtez-le avec stop (voir Service).
  • Linux et macOS : un démarrage accepté dont le proxy échoue ensuite s'affiche Arrêté et non Erreur (voir ci-dessus).
  • Lanceur autonome sans le service : le menu n'a pas d'entrée Service.
  • L'icône suit le port du service installé (8736 par défaut, ou celui choisi avec install --port N, voir Choisir le port). Quand install déplace le service sur un autre port, il relance l'icône sur ce port ; s'il n'y parvient pas, il affiche « Tray icon: the running icon could not be restarted on port N; quit it, then run install again (or log out and back in). » (message en anglais) : quittez l'icône, puis relancez install ou fermez puis rouvrez votre session ; ne la lancez pas à la main, car une icône lancée à la main utilise 8736, sauf si TEGVIA_PORT vaut le même port dans ce terminal. Elle ne pilote pas un proxy situé sur une autre machine.

Voir aussi Dépannage.

Fichiers

L'icône garde ses réglages dans ~/.tegvia/state/tray.json (vos choix de notification) et écrit son journal dans ~/.tegvia/state/tray.log (un fichier tournant, jamais de contenu de requête). Un plantage inattendu de l'icône y est aussi consigné. Le dossier est le dossier de données.

Mentions des composants tiers

L'icône utilise, sous Linux, dbus-fast et, sous macOS, PyObjC (la liaison avec le framework Cocoa). Les deux sont publiés sous licence MIT. Windows n'utilise que la bibliothèque standard de Python. Leurs textes de licence complets accompagnent les paquets installés dans le dossier .deps/.