Utilisation des GitHub Copilot CLI données de session

Copilot CLI stocke les données de vos sessions CLI localement sur votre ordinateur et synchronise par défaut les sessions avec votre GitHub compte. Ces données de session vous permettent de :

• Reprendre les sessions précédentes et reprendre là où vous vous êtes arrêté.
• Utilisez la commande slash /chronicle pour générer des rapports de mêlée, obtenir des conseils personnalisés et recevoir des suggestions pour améliorer votre fichier .github/copilot-instructions.md.
• Posez des Copilot questions sur vos interactions passées.

Cet article explique comment utiliser ces fonctionnalités à partir de Copilot CLI. Pour plus d’informations sur la façon dont les données de session sont stockées et synchronisées, consultez À propos des données de session GitHub Copilot. Pour interroger vos sessions à partir de VS Code, consultez Gestion des sessions des agents.

Reprise d’une session précédente

Vous pouvez reprendre une session CLI interactive précédente à partir de la ligne de commande ou pendant une session active.

• À partir de la ligne de commande, exécutez copilot --continue pour reprendre votre session la plus récente. Si vous souhaitez choisir parmi une liste de sessions récentes, exécutez copilot --resume pour ouvrir un sélecteur de sessions qui répertorie vos sessions récentes. Sinon, si vous connaissez l’ID de session de la session que vous souhaitez reprendre, vous pouvez courir copilot --resume SESSION-ID pour y accéder directement.

• Pendant une session interactive, tapez /resume pour basculer vers une autre session. Un sélecteur s’affiche en affichant vos sessions récentes. Vous pouvez également entrer /resume SESSION-ID pour accéder directement à une session spécifique.

Lorsque vous reprenez une session, Copilot charge l’historique complet des conversations, vous pouvez donc continuer exactement là où vous vous êtes arrêté.

Renommer une session

Lorsque vous utilisez l’option --resume de ligne de commande ou la /resume commande de barre oblique, vos sessions récentes sont répertoriées. La dernière colonne de la liste affiche le nom de session, ce qui vous permet d’identifier la session que vous souhaitez reprendre. Si vous avez une session à laquelle vous revenez fréquemment, vous pouvez lui donner un nom personnalisé pour faciliter la recherche dans la liste.

Pour renommer une session :

1. Dans une session interactive, si vous souhaitez renommer une session autre que la session active, utilisez la /resume commande barre oblique pour basculer vers la session que vous souhaitez renommer.

2. Tapez /rename NEW_NAME pour renommer la session active. Vous n’avez pas besoin de placer le nom entre guillemets.

   Par exemple : /rename Improve test coverage.

Partage d’une session

Vous pouvez partager le contenu de la session active en tant que lien partageable vers la session sur GitHub.com, un fichier Markdown, un fichier HTML interactif ou un gist privé sur GitHub.com. Cela vous permet de partager vos invites et les réponses de Copilot avec d'autres personnes, ou de stocker un enregistrement de votre travail en dehors de l'interface CLI.

Pour partager la session avec GitHub et imprimer un lien de partage, saisissez la commande suivante dans une session interactive :

/share

/share

Pour arrêter le partage de la session, tapez /share off.

Pour partager une session en tant que gist, tapez :

/share gist

/share gist

Pour exporter la conversation de session en tant que fichier Markdown, tapez :

/share file [PATH-TO-FILE]

/share file [PATH-TO-FILE]

Si vous ne spécifiez pas de chemin d’accès de fichier, le fichier Markdown est enregistré dans le répertoire de travail actif avec le nom copilot-session-SESSIONID.md.

Pour exporter la session en tant que fichier HTML interactif, tapez :

/share html [PATH-TO-FILE]

/share html [PATH-TO-FILE]

Comme avec l’exportation Markdown, si vous ne spécifiez pas de chemin d’accès de fichier, le fichier est enregistré dans le répertoire de travail actif, avec le nom copilot-session-SESSIONID.html.

Si vous avez utilisé la /research commande de barre oblique dans la session active, vous pouvez également utiliser la /share commande pour partager un rapport de recherche. Pour plus d’informations, consultez « Recherche avec GitHub Copilot CLI ».

Utilisation de la commande slash /chronicle

La /chronicle commande slash fournit un ensemble de sous-commandes qui génèrent des types spécifiques d’insights à partir de votre historique de session. Bien que vous puissiez poser Copilot des questions de forme libre sur vos sessions à tout moment, /chronicle les sous-commandes offrent un moyen rapide d’obtenir des insights spécifiques.

Lorsque vous tapez /chronicle sans argument, un sélecteur s’affiche pour vous permettre de choisir parmi les sous-commandes disponibles :

Vous pouvez également appeler une sous-commande directement, sans utiliser le sélecteur, par exemple /chronicle standup.

/chronicle standup

Cela génère un rapport court basé sur vos Copilot CLI sessions, par défaut à partir des dernières 24 heures. Copilot examine les branches sur lesquelles vous avez travaillé, ce que vous avez accompli, ainsi que les GitHub pull requests ou les problèmes auxquels vous avez fait référence. Il regroupe la sortie par statut de réalisation, avec chaque élément étiqueté par sa branche, et vérifie l'état actuel des pull requests liées.

Exemple de résumé de standup

Standup for March 13 2026:

✅ Done

myapp-repo repo maintenance (main branch)

 - Synced local, cleaned files, audited deps, reviewed architecture
 - Session: 69a027e4-9b7b-493e-922e-107acd25abab

🚧 In Progress

MyApp configuration (suppress-start-message branch, myapp-repo)

 - Suppressing startup init prompt message
 - Session: 3034d813-3e1f-413a-b3d9-15427ef8c19c

Vous pouvez ajouter un contexte supplémentaire à la commande pour personnaliser la sortie. Par exemple, vous pouvez indiquer Copilot d’utiliser une période différente, plutôt que les dernières 24 heures par défaut :

/chronicle standup for the last 3 days

/chronicle standup for the last 3 days

/chronicle tips

Cela analyse vos sessions récentes pour comprendre comment vous travaillez et comment vous utilisez Copilot CLI. Il fournit ensuite 3 à 5 recommandations personnalisées. Copilot examine vos invites réelles, les outils que vous utilisez et les fonctionnalités que vous n’avez pas encore essayées. Il fait référence à ceci avec l’ensemble complet de fonctionnalités CLI disponibles, y compris les agents personnalisés et les compétences que vous avez configurés dans le référentiel, pour trouver des opportunités que vous pourriez manquer.

Les conseils sont ancrés dans vos données d’utilisation réelles, ce qui vous donne des suggestions spécifiques plutôt que des conseils génériques.

Exemples de conseils

Voici un exemple des points principaux d’une /chronicle tips réponse. Dans une réponse réelle, chaque point est expliqué plus en détail.

1. Use @ to mention files instead of pasting content
2. Iterate within a session — don't start over
3. Try /research for your exploration work
4. Turn recurring prompts into a custom agent
5. Use plan mode for multi-step work

Vous pouvez concentrer les conseils sur une zone spécifique en ajoutant le contexte après /chronicle tips. Par exemple:

/chronicle tips for better prompting

/chronicle tips for better prompting

/chronicle cost-tips

Cela analyse l’utilisation de vos jetons dans les sessions récentes pour montrer où les jetons sont dépensés et suggère des moyens de réduire les coûts. Copilot analyse des schémas tels que la longueur des prompts, la fréquence des appels aux outils et les étapes de continuation afin d’identifier des possibilités d’utilisation plus efficace.

/chronicle cost-tips

/chronicle cost-tips

/chronicle search

Cela recherche tout votre contenu de session (pas seulement des résumés) pour des mots clés ou des rubriques spécifiques. Contrairement aux questions de forme libre qui s’appuient sur la compréhension sémantique, /chronicle search effectue une recherche directe de contenu, ce qui le rend utile lorsque vous connaissez le terme exact ou la rubrique que vous recherchez.

/chronicle search authentication

/chronicle search authentication

/chronicle improve

Cela effectue une analyse approfondie de votre historique de session pour identifier les moments où Copilot a rencontré des difficultés à fournir le type de réponse ou de résultats que vous recherchiez, ou où vous avez dû rectifier le tir en proposant des instructions supplémentaires. Sur la base de cette recherche, il suggère des améliorations apportées à votre .github/copilot-instructions.md fichier d’instructions personnalisées.

Capturer des connaissances spécifiques au projet en tant qu’instructions personnalisées est un moyen puissant d’améliorer les performances de Copilot lors de la réalisation de votre projet. Pour plus d’informations, consultez « Ajout d’instructions personnalisées pour GitHub Copilot CLI ».

Copilot recherche des signaux de friction : échecs de test répétés, erreurs de génération nécessitant plusieurs tentatives, messages utilisateur qui ont corrigé ou redirigé l’agent et des modèles qui se répètent entre les sessions. Il présente ensuite 3 à 5 recommandations spécifiques, chacun expliquant le problème qu’il a trouvé et l’instruction qui le traiterait.

Par exemple, Copilot il peut trouver qu’il a essayé à plusieurs reprises d’utiliser jest pour votre projet qui utilise vitest, ou qu’il a continué à générer des importations dans un style qui ne correspond pas à vos conventions codebase. Les instructions suggérées empêcheraient ces erreurs lors des prochaines sessions.

Après avoir présenté ses recommandations, Copilot vous demandez celles que vous souhaitez appliquer. Par défaut, toutes les recommandations sont sélectionnées, mais vous pouvez utiliser les touches de direction de votre clavier pour accéder à l’une des recommandations, puis appuyer sur la barre d’espace pour désactiver la suggestion. Après avoir choisi les recommandations à appliquer, appuyez sur Entrée. Copilot crée ou met à jour le .github/copilot-instructions.md fichier.

Poser des questions sur votre historique de session

Vous n’avez pas besoin d’utiliser une commande slash pour profiter de votre historique de session. Si Copilot détermine que vous posez une question sur l'utilisation de l'interface CLI, il utilisera automatiquement le stockage de sessions pour fournir le contexte nécessaire à une réponse.

Voici quelques exemples des types de questions que vous pouvez poser :

Aperçus sur les tâches

Using what you know about my sessions, what type of tasks give me one-shot successes and which do I have to iterate on most?

Using what you know about my sessions, what type of tasks give me one-shot successes and which do I have to iterate on most?

Copilot analyse vos conversations, recherche des heures où une réponse initiale n’a pas été suivie d’invites associées, et des heures où il y a eu une série d’invites itératives et de réponses.

Réduire l’utilisation de GitHub AI Credits

Based on my previous CLI sessions, how could I prompt you in a way that would cost less?

Based on my previous CLI sessions, how could I prompt you in a way that would cost less?

Copilot examine vos modèles de session ( longueur d’invite, nombre d’étapes de continuation et fréquence d’appel d’outil) et suggère des façons d’obtenir les mêmes résultats avec moins d’interactions.

Trouver vos temps les plus productifs

Look at data for previous sessions. What time of day am I most and least effective at getting good results from Copilot?

Look at data for previous sessions. What time of day am I most and least effective at getting good results from Copilot?

Copilot interroge les horodatages de session et les résultats pour identifier quand vos interactions ont tendance à être plus efficaces.

Rappeler le travail passé

Have I worked on anything related to authentication in the last month?

Have I worked on anything related to authentication in the last month?

Copilot utilise la recherche en texte intégral dans l’historique de votre session pour rechercher les sessions pertinentes, puis résume ce que vous avez fait.

Suppression de sessions

La façon la plus simple de supprimer des sessions consiste à utiliser la /session commande barre oblique dans une session CLI interactive.

• /session delete supprime la session active et démarre une nouvelle session à sa place.
• /session delete SESSION-ID supprime une session spécifique. Cela montre d’abord un aperçu ; ajouter --yes pour confirmer, par exemple /session delete SESSION-ID --yes.
• /session delete-all supprime toutes vos sessions locales à l’exception de la session actuelle. Ajouter --yes pour confirmer : /session delete-all --yes. Les sessions utilisées par un autre processus sont ignorées.
• /session prune --older-than DAYS supprime les sessions antérieures au nombre de jours spécifié. Ajoutez-y --dry-run pour afficher un aperçu de ce qui serait supprimé.

Lorsque vous supprimez une session qui a été synchronisée avec votre compte, /session delete indiquez si vous souhaitez également supprimer la copie synchronisée (distante). La suppression de la copie synchronisée supprime également la session de vos /chronicle analyses et résultats de requête. /session delete-all Les /session prune sous-commandes affectent uniquement les sessions locales et ne suppriment pas les données synchronisées. Pour supprimer des données synchronisées pour ces sessions, supprimez-les manuellement de GitHub.com.

Pour obtenir la liste complète des /session sous-commandes, consultez Référence de commande CLI pour GitHub Copilot.

Suppression manuelle des données de session

• Données locales : pour supprimer les données d’une session CLI particulière localement, supprimez le répertoire de session approprié de ~/.copilot/session-state/. Pour effacer toutes les données de session locale, supprimez tout sous ~/.copilot/session-state/. Une fois cela fait, vous devez réindexer manuellement le magasin de sessions. Consultez Réindexation du stockage des sessions plus loin dans cet article. La suppression de fichiers locaux n’affecte pas les données de session qui ont été synchronisées avec votre compte. Vous ne pouvez pas supprimer les données synchronisées localement.
• Données synchronisées : vous pouvez supprimer ou masquer des sessions CLI synchronisées à partir de GitHub.com. Le masquage d’une session le supprime de votre index de session afin qu’elle ne s’affiche plus dans les résultats de la requête. La suppression d’une session la supprime de votre liste de sessions sur GitHub.com. La suppression s’applique aux sessions CLI, VS Code et GitHub Copilot app.

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. La réindexation synchronise également vos données de session avec votre compte.

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 : Pour supprimer une session de votre historique, utilisez les commandes slash /session delete, /session delete-all ou /session prune. Pour une session synchronisée, /session delete peut également supprimer la copie synchronisée, ce qui supprime la session de vos informations /chronicle.
• 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 :

/chronicle reindex

/chronicle reindex

Lectures complémentaires

• À propos des données de session GitHub Copilot
• Gestion des sessions des agents
• Référence de commande CLI pour GitHub Copilot