À propos de CLI de GitHub Copilot données de session

Copilot CLI enregistre chaque session localement. Vous pouvez continuer les sessions précédentes, poser Copilot questions sur vos interactions avec l’interface CLI et utiliser la commande slash /chronicle pour obtenir des insights utiles sur les sessions.

Dans cet article

Présentation

Chaque fois que vous utilisez Copilot CLI, un ensemble complet de données concernant votre session, y compris vos invites, les réponses de Copilot, les outils utilisés et les détails des fichiers modifiés, est enregistré sur votre machine locale. Au fil du temps, cela crée une histoire riche de ce sur quoi vous avez travaillé, la manière dont vous avez travaillé et tout ce que Copilot a réalisé pour vous.

Ces données de session alimentent plusieurs fonctionnalités :

  •         **Reprise des sessions** : Vous pouvez reprendre là où vous vous étiez arrêté dans n’importe quelle session précédente.

  •         **Poser des questions sur votre historique** : vous pouvez poser Copilot questions sur votre travail passé et interroger vos données de session pour les répondre.

  •           **La `/chronicle` commande slash** : un ensemble de sous-commandes spécialement conçues qui génèrent des rapports de standup, des conseils personnalisés et des suggestions pour améliorer vos instructions personnalisées, le tout basé sur l’historique de vos sessions.

Cet article conceptuel explique comment les données de session sont stockées et comment vous pouvez l’exploiter pour améliorer votre flux de travail. Pour obtenir un guide pratique sur la reprise d’une session, en demandant Copilot sur vos sessions CLI et en utilisant la /chronicle commande de barre oblique, consultez Utilisation des données de session CLI de GitHub Copilot.

Remarque

La commande /chronicle et la capacité de Copilot à répondre aux questions sur votre historique de session sont actuellement des fonctionnalités expérimentales et ne sont disponibles que si vous avez utilisé la commande /experimental on slash ou l'option de ligne de commande --experimental.

Stockage des données de session

Chaque session Copilot CLI est conservée sous la forme d’un ensemble de fichiers dans le ~/.copilot/session-state/ répertoire de votre ordinateur. Les données de chaque session contiennent un enregistrement complet de la session. Ces fichiers vous permettent de reprendre une session CLI interactive.

En plus des fichiers de session, Copilot CLI stocke les données de session structurées dans une base de données SQLite locale, appelée magasin de sessions. Ces données sont un sous-ensemble des données complètes stockées dans les fichiers de session. Le magasin de sessions est ce qui alimente la commande slash /chronicle et permet également à Copilot de répondre aux questions que vous posez sur vos travaux passés.

Confidentialité et localité des données

Toutes les données de session sont stockées localement dans votre répertoire de base et sont uniquement accessibles à votre compte d’utilisateur. Copilot lit ces informations sur votre ordinateur lorsque vous posez des questions sur vos interactions avec l'interface en ligne de commande (CLI) ou lorsque vous utilisez la commande slash /chronicle. Les données de session telles que vos invites précédentes, les données contextuelles et les réponses que vous avez reçues peuvent être envoyées au modèle IA, tout comme elles se trouveraient dans n’importe quelle interaction normale Copilot CLI.

Si vous souhaitez supprimer des données pour une session CLI particulière, vous pouvez supprimer le répertoire de session approprié de ~/.copilot/session-state/. Vous pouvez effacer toutes les données de session en supprimant tout sous ~/.copilot/session-state/. Une fois cela fait, vous devez réindexer manuellement le magasin de sessions. Voir reindexation du magasin de sessions plus loin dans cet article.

À propos de la /chronicle commande slash

La /chronicle SUBCOMMAND commande utilise les données du stockage de session pour fournir des analyses et des suggestions sur votre utilisation de Copilot CLI.

Vous pouvez entrer les commandes suivantes dans une session CLI interactive :

  •           `/chronicle standup` : génère un rapport succinct résumant ce sur quoi vous avez travaillé lors de vos récentes sessions CLI, incluant les noms de branches, les liens des pull requests et les contrôles de statut.

  •         `/chronicle tips`: fournit des conseils personnalisés pour l’utilisation de Copilot CLI plus efficacement.

  •         `/chronicle improve`: analyse votre historique de session pour identifier les modèles où Copilot peut avoir mal compris votre intention ou où il y avait beaucoup de back-and-forth, et génère des instructions personnalisées pour aider Copilot mieux comprendre à l’avenir.

  •         `/chronicle reindex`: Reconstruit l'espace de stockage des sessions à partir de vos fichiers d'historique de session.

Avantages de /chronicle et des données de session

  •         **Flux de travail auto-améliorant** : la `improve` sous-commande crée une boucle de commentaires qui vous permet d’affiner vos instructions personnalisées. Au fil du temps, cela rend l’agent plus efficace pour votre projet spécifique.

  •           **Rapports de standup sans effort** : Au lieu de reconstituer manuellement ce que vous avez fait hier, `/chronicle standup` génère un résumé de standup à partir des données réelles de vos sessions.

  •         **Coaching personnalisé** : la `tips` sous-commande agit comme un coach de productivité personnel qui sait à la fois ce que Copilot CLI peut faire et comment vous l’utilisez réellement. Il permet de combler l’écart entre les fonctionnalités disponibles et votre flux de travail actuel.

  •           **Parlez à votre historique de codage** : le stockage des sessions permet à Copilot de répondre à toutes les questions auxquelles vos sessions passées pourraient contribuer, comme se souvenir d'une correction de bogue que vous avez réalisée la semaine dernière ou analyser vos schémas d'invite au cours du temps.

  •         **Local et privé** : toutes les données de session ( les fichiers JSONL bruts et le magasin de sessions SQLite) restent sur votre ordinateur. Rien n’est chargé ou partagé au-delà des interactions normales du modèle d’IA qui se produisent dans n’importe quelle Copilot CLI session. Vous disposez d’un contrôle total sur vos données et pouvez la supprimer à tout moment.

Quand devez-vous utiliser ces fonctionnalités ?

  •         **Au début de votre journée** : Exécutez `/chronicle standup last 3 days` pour générer un rappel de ce que vous avez travaillé récemment et la session CLI dans laquelle vous travaillez.

  •         **Régulièrement, pour monter en puissance** : Exécutez `/chronicle tips` chaque semaine ou deux pour découvrir les fonctionnalités et les améliorations de flux de travail que vous manquez peut-être.

  •         **Lorsque Copilot effectue la même erreur** : Exécutez `/chronicle improve` pour identifier le modèle et générer des instructions personnalisées pour le corriger.

  •         **Pour rappeler le travail passé** : Posez une question de forme libre comme « Ai-je travaillé sur quelque chose lié à l’API de paiement ? » et Copilot recherche votre historique.

  •         **Pour reprendre le travail précédent** : utilisez `copilot --continue` ou `copilot --resume` pour continuer là où vous vous êtes arrêté.

Réindexation de l'espace de stockage des sessions

Le magasin de sessions est rempli de manière incrémentielle pendant une session CLI. Les données d’une session sont écrites sur le disque dans un sous-répertoire spécifique à la session de ~/.copilot/session-state/. Cela se produit également régulièrement pendant une session, ainsi que lorsque la session se termine.

Vous pouvez réindexer le magasin de sessions à partir des fichiers de session sur le disque, bien que vous n’ayez généralement jamais besoin de le faire.

Les situations où vous devrez peut-être réindexer sont les suivantes :

  •         **Indexation d’anciennes sessions** : si vous avez d’anciens fichiers de session sur le disque créés avant l’existence du magasin de sessions, la réindexation remplit le magasin de sessions avec les données de ces sessions.

  •         **Suppression** de session : si vous souhaitez supprimer une session de votre historique, vous pouvez supprimer le répertoire de session, puis réindexer le magasin de sessions.

  •         **Migration/récupération de sessions** : si vous avez déplacé vos fichiers de session vers un autre ordinateur ou restaurés à partir d’une sauvegarde, sans déplacer/restaurer le fichier de magasin de sessions (`~/.copilot/session-store.db`), vous pouvez utiliser la commande de réindexation pour recréer le magasin de sessions.

  •         **Altération** des fichiers : si le fichier de magasin de sessions (`~/.copilot/session-store.db`) devient endommagé ou est supprimé accidentellement, vous pouvez récupérer le magasin de sessions à partir des fichiers de session.

  •         **Arrêt inattendu** : si une session se termine de manière inattendue (par exemple, en raison d’un blocage ou d’une perte d’alimentation) avant que les données conservées en mémoire aient été vidées dans le magasin de sessions, vous pouvez peut-être remplir le magasin de sessions avec les données manquantes si elles ont été écrites sur le disque, dans les fichiers de session, avant l’arrêt.

Pour réindexer la boutique de sessions, utilisez la commande slash suivante dans une session CLI interactive :

Copilot prompt
/chronicle reindex

Lectures complémentaires

  •         [AUTOTITLE](/copilot/how-tos/copilot-cli/chronicle)

  •         [AUTOTITLE](/copilot/reference/cli-command-reference)