Aller au contenu
Bosco
Guides

Réglages

Les sept onglets des réglages de Bosco - Sources, Téléphone, Notifications, Abonnement Claude, Bac à sable, Données et À propos.

« Réglages », en bas de la barre latérale, s'ouvre sur l'onglet Sources. Les sept onglets sont « Sources », « Téléphone », « Notifications », « Abonnement Claude », « Bac à sable », « Données » et « À propos ». Sur le téléphone, ils sont en lecture seule.

Sources

Réglages › Sources : deux profils surveillés, avec le suivi en direct installé

Les sources sont les profils Claude Code que Bosco lit : ~/.claude (pro), ~/.claude-perso (perso)… Bosco les lit sans rien modifier, sauf quand tu installes le suivi en direct ou le canal.

La source « Bacs à sable » est à part : « Tenue par Bosco », elle réunit les conversations de tes bacs à sable. Elle est toujours lue, sans interrupteur, ni « Gérer », ni suivi en direct ou canal à installer, et dit « Piloté par Bosco » avec son activité (« 1 bac à sable · dernier tour à 15:12 »).

Chaque profil affiche :

  • son libellé, « Actif » ou « En pause », son chemin, et « Gérer » ;
  • le suivi en direct : « Suivi en direct installé » avec la date du dernier signal, ou « Suivi en direct non installé » avec « Installer » ;
  • le canal de Bosco : « installé » ou « non installé » ;
  • l'interrupteur « Lire le profil », qui met sa lecture en pause : les sessions déjà lues restent dans l'historique.
  • le menu ⋯, avec « Retirer la source… » (voir plus bas).

Ajouter un dossier

« Ajouter un dossier » surveille un autre dossier de configuration de Claude Code, celui d'un CLAUDE_CONFIG_DIR à toi. Il ouvre le même navigateur de dossiers que les projets, depuis ~, mais dossiers cachés compris, puisque les profils s'appellent souvent ~/.claude-*. Choisis le dossier, puis « Ajouter » : « Dossier ajouté : pro est surveillé. » Un dossier qui n'est pas un profil de Claude Code est refusé : « Ce dossier n'est pas un dossier de configuration de Claude Code. » Le navigateur n'existe que sur le poste.

« À mettre à jour »

Un profil passe « À mettre à jour » dans deux cas :

  • son suivi en direct vient d'une autre version de Bosco (adresse, secret ou événements différents) : la ligne dit « Suivi en direct à mettre à jour », et « Mettre à jour » le réinstalle ;
  • Bosco ne sait plus lire ses nouvelles sessions, parce qu'une version de Claude Code a changé le format de ses transcripts : après trois nouvelles sessions illisibles d'affilée, ses nouvelles sessions ne sont plus lues, jusqu'à ce que Bosco soit mis à jour puis relancé. Les sessions déjà lues ou déjà commencées le restent.

Installer le suivi en direct

Le suivi en direct ajoute à settings.json du profil des hooks HTTP vers Bosco, pour six événements : SessionStart, SessionEnd, UserPromptSubmit, PostToolUse, PermissionRequest et Stop. C'est lui qui permet de savoir qu'une session t'attend et de répondre à une autorisation.

L'installation se fait en trois étapes. La case « Garder une copie des réglages actuels » est cochée par défaut. Bosco vérifie ensuite « Réglages écrits », « Bosco joignable », puis « Signal reçu d'une session ouverte » : ouvre une session Claude Code dans ce profil pour terminer. « Désinstaller » retire les hooks.

Réglages des sources

  • « Seuil d'inactivité » : après combien de minutes sans événement une session passe « Inactive » (5 à 60 min, 15 par défaut).
  • « Historique conservé » : « Tout ». Bosco garde sa propre copie des sessions, même quand Claude Code efface les siennes après 30 jours.

Gérer un profil

« Gérer » ouvre la page d'un profil :

  • « Abonnement » : le compte Claude du profil, et s'il est le profil par défaut de Bosco ;
  • l'accès à l'abonnement : « Connexion Claude (/login) » quand le profil est connecté, ou « Jeton longue durée (claude setup-token) » (voir plus bas) ;
  • « Valeurs par défaut des sessions » : « Autorisations », « Modèle » et « Effort » des sessions lancées dans Bosco avec ce profil. L'option « Celui du profil Claude Code · … » reprend la valeur de son settings.json. Voir Valeurs par défaut ;
  • « Utilisé par » : les groupes qui l'ont pour profil par défaut, et les sessions ouvertes, « Non modifiées par ces réglages ».

Jeton longue durée

Un profil sans connexion /login (« Aucun accès ») ne peut pas servir d'abonnement à une nouvelle session : il y apparaît grisé, « aucun accès · à régler dans le profil ». Deux façons de lui donner accès : se connecter avec /login dans ce profil, ou « Utiliser un jeton longue durée ».

Ce bouton ouvre le navigateur de fichiers, fichiers cachés compris : choisis le fichier où tu as rangé le jeton créé par claude setup-token, par exemple ~/.config/claude-equipe/jeton. Bosco ne garde que son chemin, jamais le jeton : il le relit à chaque tour et le passe à Claude Code, sur le poste comme dans un bac à sable. Un jeton déclaré l'emporte sur la connexion du profil ; « Retirer » l'oublie. Un fichier absent, illisible ou vide s'affiche en orange sous l'accès.

Retirer une source

« Retirer la source… », dans le menu ⋯ d'un profil, fait oublier à Bosco ce profil et ses sessions : historique, usage et notifications. C'est la différence avec l'interrupteur « Lire le profil », qui met la lecture en pause en gardant tout. Bosco retire aussi du profil ce qu'il y avait installé (suivi en direct, canal), réglages d'avant remis. Rien n'est supprimé dans le dossier de Claude Code : « Ajouter un dossier » rajoute le profil, et son historique est relu.

Les groupes dont ce profil était le profil par défaut reprennent l'abonnement par défaut de Bosco. Une session de ce profil dont un tour tourne dans Bosco bloque le retrait : « Une session de ce profil tourne : arrête-la d'abord ».

Téléphone

  • L'interrupteur « Accès depuis le téléphone » ouvre l'écoute HTTPS du réseau local et la fenêtre d'appairage. Coupé : « Désactivé : aucun accès en dehors de ce poste. »
  • « Appairer un téléphone » : le QR code, l'adresse et le code à six chiffres, valable 5 minutes et à usage unique.
  • « Téléphones appairés » : chaque téléphone, avec « Retirer », qui coupe son accès aussitôt.

Le détail de l'appairage est dans Application Android. Même appairé, un téléphone ne modifie ni les réglages, ni les projets, ni les groupes, ni le contexte.

Notifications

Ce qui notifie, et où : voir Notifications.

Abonnement Claude

  • « Abonnement par défaut » : le profil proposé à chaque nouvelle session. Un bac à sable en reçoit une copie de l'accès. « Modifier » en choisit un autre.
  • Les jauges « Fenêtre de 5 h » et « Semaine » de l'abonnement.
  • Les seuils « Ne plus lancer de tour au-delà de » et « Arrêter le tour au-delà de », pour chaque fenêtre, en pourcentage (50 et 80 % sur 5 h, 70 et 90 % sur la semaine par défaut).
  • « Les seuils retiennent » : « Sessions en bac à sable » ou « Sessions en bac à sable et pilotées sur le poste ».

Voir Le quota de l'abonnement.

Bac à sable

Réglages › Bac à sable : ce que voit l'agent, ses ressources et les domaines autorisés

  • « Un conteneur par session » : ce que fait un bac à sable, et quand il s'arrête.
  • « Ce que voit l'agent » : fichiers, secrets et réseau, ce à quoi il a accès et ce à quoi il n'a pas accès.
  • « Ressources de chaque bac à sable » : mémoire, processeurs, processus, utilisateur sans droits d'administration, et le contenu de l'image.
  • « Domaines autorisés » : les domaines par défaut, verrouillés, et ceux « Ajoutés par toi ». Un domaine s'écrit seul, sans protocole ni chemin : pypi.org ou *.github.com.

Voir Bac à sable.

Données

  • « Période importée » : « 30 derniers jours » (par défaut) ou « Tout l'historique », pour tous les profils surveillés. Claude Code efface ses transcripts après 30 jours par défaut : « Tout l'historique » lit en arrière-plan les sessions plus anciennes encore présentes dans les profils, les plus récentes d'abord, avec le bandeau d'import. Revenir à « 30 derniers jours » garde ce qui est déjà importé.
  • « Sessions importées » et « La plus ancienne » : ce que Bosco a déjà lu, et ce que « Tout l'historique » ajouterait.
  • La base de Bosco : son dossier (~/.local/share/bosco) et sa taille, bacs à sable compris. Bosco y garde sa propre copie des sessions : une session effacée par Claude Code reste dans l'historique et l'usage.

Réinitialiser Bosco

« Réinitialiser Bosco… » efface tout ce que Bosco a gardé : sources, projets et groupes, sessions lues et leur usage, sessions pilotées, notifications, contexte des projets, téléphones appairés et réglages. Ce que Bosco a installé dans chaque profil en est retiré. Les bacs à sable sont arrêtés et leurs copies supprimées : une branche pas encore récupérée serait perdue, et la confirmation la nomme.

Pour confirmer, écris « RÉINITIALISER » (majuscules et accents facultatifs), puis « Tout effacer ». Bosco s'ouvre ensuite sur le premier lancement. Les dossiers et les sessions de Claude Code ne sont jamais touchés. Pas de réinitialisation depuis le téléphone, qui perd son accès et revient à l'appairage.

À propos

  • « Version » : la version qui tourne et l'installation (paquet .deb, AppImage ou depuis le dépôt). Une bêta se lit « 0.3.0-beta.1 · bêta » ; une version construite hors d'une release (make beta, make dev) porte son commit, « 0.2.0 · 3118cb5 ».
  • « Mises à jour » : Bosco cherche une version plus récente une fois par jour au plus dans les releases publiées sur GitHub, par un appel en lecture, sans identifiant. « Chercher les nouvelles versions » se coupe ; le « Canal des mises à jour » « Stable » ne propose que les versions stables, « Bêta » aussi les bêtas. « Vérifier maintenant » cherche tout de suite.
  • La version disponible : ses notes, le paquet .deb à télécharger (l'APK sur le téléphone) et la release sur GitHub. L'AppImage n'a rien à télécharger : elle se met à jour seule, puis la barre système propose « Relancer pour mettre à jour ».
  • « Nouveautés » : le journal des versions (CHANGELOG.md) embarqué avec la version qui tourne, une section par version, chaque ligne liée à sa PR.

Un bandeau en haut de page annonce une fois « Bosco 0.3.0 installé » après une mise à jour, sinon « Version 0.3.0 disponible » ; « Voir les nouveautés » mène à cet onglet, et une fois fermé il ne revient plus pour cette version. La fenêtre « À propos » du logo y mène aussi.

Conteneurs en cours

Les conteneurs ne sont pas un onglet : « Conteneurs » apparaît en bas de la barre latérale dès qu'un conteneur tourne (sur le téléphone, « Conteneurs en cours » dans les Réglages). Voir Les conteneurs en cours.

Sur cette page