Passer au contenu principal
Afficher en Markdown

Sessions

Chaque onglet de clavardage dans Kiro Crew est sa propre conversation. Les conversations sont indépendantes : chacune a son propre contexte, son propre historique et son propre état d'approbation d'outils. Vous pouvez en avoir plusieurs ouvertes à la fois, chacune travaillant sur des choses différentes.

Onglets de session

Les sessions s'ouvrent sous forme d'onglets au-dessus de la transcription. L'ensemble des onglets ouverts persiste par surface, de sorte que fermer puis rouvrir le tableau de bord restaure vos onglets.

  • Sélectionnez + dans la barre d'onglets pour créer une session
  • Cliquez avec le bouton du milieu ou une touche modificatrice sur une ligne de la barre latérale pour l'ouvrir sans quitter l'onglet actuel
  • Cliquez avec le bouton du milieu ou une touche modificatrice sur le + d'un dossier pour créer un onglet en arrière-plan dans ce dossier
  • Chaque onglet indique si sa session est en train de réfléchir, d'attendre ou inactive
  • Chaque session conserve sa propre fenêtre de contexte, son état d'approbation, son projet et son agent

Les sessions démarrées depuis Slack, Telegram, Discord ou un autre canal sont indépendantes des onglets du tableau de bord. Elles partagent la mémoire à long terme mais pas le contexte de session.

Lorsque vous choisissez un projet pour une session, le sélecteur de projet comporte les onglets Favorites, Recent et Browse. Marquez un projet d'une étoile depuis Recent ou Browse pour l'ajouter aux Favorites. Le sélecteur s'ouvre sur Favorites dès que vous en avez.

Page de toutes les sessions

Ouvrez /sessions pour un sélecteur avec signet qui ne crée ni ne sélectionne jamais de session automatiquement. Il comprend la recherche par titre, les filtres All et Unread, des pastilles d'état, et des groupes Today, Yesterday et Earlier. Utilisez-le lorsque la navigation par dossier ou la recherche dans la barre latérale est trop limitée.

Regroupement des sessions inactives

Les sessions inactives au-delà d'un seuil se regroupent dans une section extensible Dormant sessions (N). Les sessions épinglées, en cours et non lues restent visibles.

Configurez le seuil dans Settings → Chat → Collapse dormant sessions. La valeur par défaut est de 7 jours; choisissez Never pour garder toutes les sessions visibles.

Modes de mémoire

Les nouveaux clavardages du tableau de bord utilisent le mode sélectionné dans Settings → Chat → Default Memory Mode. Un choix explicite lors de la création d'une nouvelle session l'emporte toujours.

ModeLit la mémoireÉcrit dans la mémoire
Persistent (par défaut)OuiOui
IncognitoOuiNon
TemporaryNonNon

Incognito peut utiliser vos préférences, leçons et historique, mais la conversation n'écrit rien en retour. Temporary démarre sans lire ni écrire de mémoire. Les deux modes marquent l'onglet visuellement, et l'un ou l'autre peut être bifurqué.

Écriture à l'avance, Steer et Queue

Lorsque l'agent travaille encore, le bouton d'envoi divisé vous propose deux choix :

  • Steer délivre le message au tour en cours
  • Queue le stocke pour le prochain tour

Kiro Crew mémorise l'action préférée pour chaque session. Cmd+Entrée sur macOS ou Ctrl+Entrée ailleurs effectue l'autre action une fois lorsque le bouton divisé est visible et qu'Entrée est votre raccourci d'envoi.

Les messages en file d'attente s'exécutent dans l'ordre. Vous pouvez modifier, réordonner ou annuler une carte en file d'attente; l'annulation restaure son texte et ses pièces jointes dans le compositeur. Une fois que Kiro Crew accepte un message en file d'attente, il écrit la file sur disque, de sorte que la carte revient après un redémarrage de la passerelle. Stop annule le tour en cours et laisse le prochain message en file d'attente continuer.

Mode chef d'orchestre

Le mode chef d'orchestre (Conductor mode) permet à un clavardage de diriger une équipe de travailleurs vers un objectif. Le chef d'orchestre établit son plan à partir de l'objectif, le met à l'épreuve avant de commencer, retient des valeurs par défaut raisonnables au lieu de poser des questions et vérifie à chaque ronde que le nouveau travail de chaque travailleur ne dérive pas. Lorsqu'un travailleur fait fausse route, il ne replanifie que cet élément. Il examine aussi chaque élément ouvert toutes les heures, et il envoie des messages à ses propres travailleurs et les ferme sans invite d'approbation.

Cela diffère de la file d'attente, qui exécute les messages dans l'ordre sur une seule session. Le mode chef d'orchestre s'appelait Ultra Mode dans Kiro Crew 0.12.0 et était un Aperçu de fonctionnalité. Dans Kiro Crew 0.13.0 ou une version ultérieure, il est activé dans toutes les versions standard sans rien à activer, et un commutateur enregistré de l'aperçu est ignoré. L'édition LTS ne l'offre pas.

  • Le démarrer : le compositeur d'un nouveau clavardage offre le commutateur du mode chef d'orchestre. Un clavardage en cours l'offre à droite du bouton des permissions, et ce clavardage reste ensuite en mode chef d'orchestre.
  • L'exécuter à chaque nouveau clavardage : activez Paramètres → Chat → Sessions → Start New Chats in conductor mode (désactivé par défaut).
  • Choisir le chef d'orchestre : les clavardages s'exécutent sur l'agent kirocrew-conductor, sauf si agent.crew_mode_agent nomme un autre agent.
  • Diriger l'équipe : l'onglet Board du panneau latéral énumère les travailleurs du clavardage, les travailleurs de chaque responsable repliés sous lui, avec la machine sur laquelle chacun s'exécute. Pause all arrête tous les travailleurs en cours d'exécution, sous-équipes comprises, jusqu'à Resume all, même après un redémarrage de la passerelle. Le Board affiche le texte complet de chaque élément, et le clavardage indique quand une exécution est terminée ou arrêtée.

La liste Sessions dessine un clavardage en mode chef d'orchestre comme une carte d'équipe, avec un filtre Conductor mode. Ses travailleurs apparaissent sur le Board, et non comme des lignes de votre liste.

Reprendre, exporter et importer

Les sessions survivent aux redémarrages de la passerelle. Les onglets ouverts se reconnectent automatiquement, et rouvrir un clavardage antérieur le charge en arrière-plan pendant que vous lisez. Revenir en arrière restaure votre position de lecture.

Depuis les canaux pris en charge, utilisez la commande sessions pour trouver les conversations récentes et en reprendre une. Vous pouvez également lier une conversation du tableau de bord à un fil Slack pour une synchronisation bidirectionnelle.

Utilisez Export to a file depuis le menu de session pour déplacer une session persistante vers une autre machine. Utilisez Import a session from a file dans la barre latérale pour la ramener. Les sessions envoyées depuis une machine paire sont classées sous Imported, regroupées par expéditeur. Définissez dashboard.export_include_layer_b uniquement lorsque vous voulez délibérément qu'un export contienne la couche de contexte de modèle nécessaire pour une reprise directe; elle est désactivée par défaut.

Trouver des sessions

La recherche dans la barre latérale couvre les passerelles connectées et entrelace les résultats locaux et distants. Recherchez par titre, pull request, revue de code, badge de ticket, ou des formes telles que 4411, /pull/4411 et owner/repo#4411. Un préfixe title: limite la recherche aux titres de session.

Dans Kiro Crew 0.13.0 ou une version ultérieure, les résultats sont classés du meilleur au moins bon, chacun avec la raison de sa correspondance. Une expression entre guillemets reste entière, et un mot précédé de - est exclu.

Atteindre le haut d'une longue transcription charge les tours plus anciens. Pour un inventaire avec des filtres explicites et sans sélection automatique, utilisez la page /sessions.

Filtres et dossiers de la barre latérale

Le menu de filtres de la barre latérale comporte les pastilles Unread, In progress et Pinned. Chaque pastille peut n'afficher que les sessions correspondantes ou, avec son contrôle en forme d'œil barré, les masquer. Pause all filters lève toutes les pastilles d'état à la fois, et Resume all filters les rétablit.

Une session épinglée reste visible pendant qu'un filtre d'étiquette ou d'état réduit le reste. La recherche et un dossier masqué s'appliquent toujours à elle.

Trier les sessions à la main

Le menu de filtres Sort sessions by choisit la dernière activité, la création, le nom ou Manual. Déposer une session entre deux lignes non épinglées fait passer le tri à Manual et affiche un avis Sorted by hand avec une option Undo. Sous Manual, Alt+Haut et Alt+Bas déplacent une ligne non épinglée ayant le focus. L'ordre et le choix de tri sont stockés sur la passerelle, de sorte que chaque navigateur affiche la même liste.

Diffusion et dossier des nouveaux clavardages

Le Broadcast message du menu d'en-tête de la barre latérale envoie un seul message à plusieurs sessions que vous choisissez. Settings → Chat → Default Sidebar Folder for New Chats nomme le dossier dans lequel un nouveau clavardage démarre.

Trois contrôles rangent les dossiers :

  • Choisissez Clean up empty folders depuis le menu d'en-tête de la barre latérale. Il prévisualise les dossiers qui ne contiennent aucune session ouverte ni aucun paramètre. Cochez Include top-level folders pour les ajouter, puis confirmez avec le bouton de suppression, qui indique combien de dossiers il supprime. Un dossier qui reçoit une session après la prévisualisation est conservé. Les anciennes sessions d'un dossier supprimé restent dans Older Sessions.
  • Cliquez sur la ligne de connexion à côté des lignes d'un dossier ouvert pour replier le dossier. La bascule de l'en-tête de dossier reste le contrôle au clavier.
  • Un chemin de dossier écrit en code en ligne dans le clavardage, comme projects/billing, devient une puce qui révèle le dossier dans la barre latérale. La puce n'apparaît que lorsqu'un seul dossier porte ce chemin complet.

Autres commandes de dossiers et de filtres

Dans Kiro Crew 0.13.0 ou une version ultérieure :

  • Le menu d'un dossier ajoute Close sessions and delete…. Le menu de la liste Sessions ajoute Collapse all folders. Les Folder settings acceptent un Default first prompt par lequel commence chaque nouveau clavardage démarré depuis ce dossier.
  • Paramètres → Chat → Sessions → Include Subfolder Contents in Folder Counts fait afficher à un dossier replié tout ce qu'il contient. L'option Folder order du menu Filter ajoute Move folders with unread chats to the top, et dashboard.unfiled_sessions_above_folders (false par défaut) place les sessions sans dossier au-dessus des dossiers.
  • Refresh PR status du menu de la liste Sessions relit maintenant chaque pastille de pull request, et Remove merged PR chips du menu Filter efface toutes les pastilles de pull requests fusionnées. Cliquer sur une pastille d'état suspend ou reprend uniquement ce filtre; seul son X l'efface.
  • La zone de recherche du sélecteur Assign tags permet de trouver, de créer et de choisir une étiquette au clavier. Paramètres → Chat → Sessions → Project tags désactive l'étiquette que chaque clavardage reçoit de son dossier de projet.
  • Les bandes d'onglets de session, de terminal et de clavardage intégré gagnent un menu List all tabs.

Passer le travail d'une session à l'autre

Les outils de contrôle de session permettent à une session de tableau de bord admissible de créer, lire, envoyer des messages et arrêter des sessions paires. Ils sont en mode refus par défaut et nécessitent un appelant reconnu. Utilisez une session paire lorsque le flux de travail doit rester visible comme son propre clavardage; utilisez un sous-agent lorsque seul le résultat doit revenir.

Notifications de fin de clavardage en arrière-plan

Notify when a background chat finishes sous Settings → Notifications → Desktop alerts est désactivé par défaut. L'activer demande l'autorisation de notification du système d'exploitation et vous alerte uniquement lorsque le clavardage terminé est derrière une autre application ou fenêtre.

Mark sessions unread only when they need you, dans la même section, marque une session en arrière-plan comme non lue uniquement lorsque son agent termine ou attend votre réponse, plutôt qu'à chaque nouveau message.

Autopilot

Activez Autopilot pour une session lorsque vous souhaitez que les appels d'outils qui passent la vérification de sécurité se déroulent sans invites individuelles. Les commandes refusées, les chemins sensibles et la politique de gouvernance s'appliquent toujours.

Délai d'inactivité

Les sessions se ferment après 60 minutes d'inactivité par défaut. La fermeture libère les ressources d'exécution mais préserve la conversation pour la reprise. Définissez session.timeout_secs pour modifier le seuil ou 0 pour désactiver le balayage d'inactivité.

Ce que l'agent retient

PortéeCe qui est retenuDurée de vie
Au sein d'une sessionContexte de conversation pour cet ongletJusqu'à la compaction ou la fin de la session du fournisseur
Entre les sessionsPréférences, contexte de projet, leçons et résumés d'historiquePersistant entre les redémarrages

Une nouvelle session persistante reçoit les couches de mémoire configurées mais pas le contexte en direct des autres onglets ouverts. Consultez Mémoire pour le modèle complet.

Résumés de session

Un résumé facultatif dans le panneau latéral explique pourquoi une session a démarré, ce qui s'est passé et ce qui reste. Il est organisé par intention plutôt que comme un journal tour par tour, avec le travail non résolu en premier.

Les résumés de session sont désactivés par défaut car en générer un utilise un tour de modèle. Activez session_summary.enabled ou résumez une session plus ancienne sur demande.

Fichiers Steering

Une session dont l'espace de travail contient des fichiers .kiro/steering/*.md hérite automatiquement de ces règles de projet. Utilisez le Steering pour les normes de programmation, les règles de déploiement et les conventions d'équipe qui doivent s'appliquer sans les répéter dans chaque requête.

Répondre depuis la barre latérale

Dans Kiro Crew 0.13.0 ou une version ultérieure, arrêter le pointeur sur une session qui vous attend, ou appuyer sur la touche flèche droite sur celle-ci, ouvre une carte avec son récapitulatif, chaque approbation et chaque question en entier, et une zone de réponse rapide. Désactivez la carte avec Paramètres → Chat → Sessions → Quick Reply Card on Hover.

Rouvrir une session fermée

Dans Kiro Crew 0.13.0 ou une version ultérieure, Cmd+Shift+T rouvre la dernière session que vous avez fermée. Utilisez Ctrl+Shift+T sous Windows et Linux, ou Alt+Shift+T dans un onglet de navigateur. Épingler un onglet de session fait en sorte qu'un clic dans la barre latérale ouvre un nouvel onglet à côté de lui.

Créer une bifurcation de session

  • Fork reporte la conversation complète dans un onglet indépendant
  • Fork tail-only ne reporte que les messages récents pour un départ plus léger

Les sessions Incognito et Temporary peuvent également être bifurquées. Le nouvel onglet est indépendant à partir de ce point.

Dans Kiro Crew 0.13.0 ou une version ultérieure :

  • /fork <prompt> continue dans une copie de la conversation, en commençant par votre requête.
  • Le menu More d'une réponse ajoute Fork with another model, qui ouvre le sélecteur de modèle de la copie.
  • Une bifurcation conserve la couleur de barre latérale de son parent et son nom Fork of jusqu'à ce que son premier message la nomme.

Conserver un clavardage Incognito ou Temporary

Le menu d'en-tête d'un clavardage Incognito ou Temporary offre Keep this chat, qui le copie dans une session ordinaire.

Compaction du contexte

Le compositeur affiche l'utilisation du contexte en pourcentage et en nombre de jetons. Kiro Crew compacte automatiquement au seuil configuré, 70 % par défaut, en repliant le contexte plus ancien dans une carte extensible Context compacted. Vous pouvez également utiliser Compact depuis le menu de session ou !compact dans Slack.

Après la compaction, le fournisseur conserve un résumé de l'intention et du travail récent plutôt que de rejouer chaque tour antérieur.

Vue conducteur et registre de travail de session

Utilisez le bouton de voie en haut de la barre latérale Sessions pour passer de l'arborescence de dossiers à la liste à plat et à la vue conducteur. La vue conducteur apparaît lorsqu'une session a ouvert une autre session et qu'aucun tableau d'étiquettes n'est actif. Elle imbrique chaque worker sous son conducteur, et un conducteur replié affiche le nombre de ses enfants et de ceux qui ont besoin de vous.

Pour un travail véritablement à long terme, un agent peut enregistrer un objectif compact, une phase, une prochaine étape, des approches rejetées et des pointeurs d'artéfacts avec session_ledger_record, puis restaurer cet état avec session_ledger_read après la compaction ou un cycle de surveillance ultérieur.

Le registre est une projection du journal Crew, qui enregistre par défaut. Définissez KIROCREW_CREW_LOG=0 avant de démarrer la passerelle pour désactiver ce journal; les écritures dans le registre sont alors refusées plutôt que repliées vers un autre stockage. C'est un état de travail de l'agent, pas un remplacement de la transcription ni une fonctionnalité à utiliser pour des requêtes ordinaires en un seul tour. Voir Système et stockage.

Le menu à trois points sur chaque onglet vous donne un accès rapide aux contrôles au niveau de la session :

  • Rename : changer le titre de l'onglet
  • Mark as unread : signaler la session pour une attention ultérieure
  • Pin : la garder en dehors de la section extensible des sessions inactives
  • Tags : organiser et filtrer les sessions
  • Session color : choisir une couleur personnalisée
  • Pop out to window : l'ouvrir dans une fenêtre séparée
  • Copy link : copier un lien vers la session
  • Export to a file : télécharger une session persistante pour sauvegarde ou transfert
  • Close session : terminer la session en direct et retirer son onglet

Le menu de ligne de la session dans la barre latérale propose aussi Regenerate title, qui remplace le titre actuel par un titre nouvellement généré.

Accès des agents aux étiquettes

Ouvrez Manage Tags pour choisir Human only, Agent: add only ou Agent: add & remove pour chaque étiquette. Une étiquette créée avant ce contrôle reste verrouillée pour les agents jusqu'à ce que le propriétaire du tableau de bord sélectionne Set up agent permissions. Ignorer cette invite conserve le réglage sûr par défaut.

Page mise à jour : 19 novembre 2026