Sessions et historique

Fonctionnement des sessions

Chaque fois que vous utilisez YeePilot, votre conversation est automatiquement sauvegardee en tant que session. Les sessions capturent vos requetes, les reponses de l'IA, les plans de commandes, les decisions d'approbation et la sortie d'execution. Vous n'avez jamais besoin de sauvegarder manuellement -- cela se fait en arriere-plan.

Lorsque vous lancez YeePilot, il reprend votre session la plus recente. Si vous preferez repartir de zero, utilisez la commande /new.

Gestion des sessions

Creer une nouvelle session

> /new

Cela cree une session vierge avec un historique de conversation propre. Votre session precedente est conservee et peut etre reprise ulterieurement.

Lister toutes les sessions

> /sessions

Cela affiche une liste de vos sessions sauvegardees avec leurs noms, dates de creation et nombre de messages. Selectionnez une session dans la liste pour y basculer.

Sessions :
  1. nginx-troubleshooting     (12 messages, il y a 2h)
  2. database-migration        (8 messages, hier)
  3. firewall-setup            (23 messages, il y a 3 jours)
 
Basculer vers : _

Renommer une session

Par defaut, les sessions sont nommees automatiquement. Donnez-leur des noms significatifs pour les retrouver plus tard :

> /rename nginx-troubleshooting

Vous pouvez egalement renommer sans argument pour etre invite a saisir un nom :

> /rename
Saisir le nouveau nom : prod-server-audit

Exporter une session

Exportez la session actuelle en tant que transcription en texte brut :

> /export

Cela sauvegarde l'integralite de la conversation -- vos requetes, les reponses de l'IA, les commandes proposees et la sortie d'execution -- sous forme de fichier texte lisible. Les exports sont utiles pour la documentation, les rapports d'incident ou le partage avec des collegues.

Gestion de la fenetre de contexte

Les modeles IA ont une fenetre de contexte limitee -- la quantite de texte qu'ils peuvent considerer en une fois. A mesure que votre conversation s'allonge, elle approche de cette limite. YeePilot gere cela automatiquement grace a la compaction du contexte.

Fonctionnement de la compaction

Lorsque la fenetre de contexte atteint environ 80 % de sa capacite, YeePilot declenche la compaction automatique :

1. Les 80 % les plus anciens des messages de la conversation sont selectionnes
2. Ces messages sont resumes en un recapitulatif concis
3. Le resume remplace les messages originaux
4. Les 20 % les plus recents des messages restent intacts

Ce processus est transparent. Vous n'avez aucune action a entreprendre et la conversation continue normalement. L'IA conserve le contexte essentiel du debut de la conversation tout en liberant de l'espace pour de nouvelles interactions.

Ce que la compaction preserve

Le resume conserve :

• Les decisions cles et les resultats
• Les chemins de fichiers et valeurs de configuration importants
• Les messages d'erreur et leurs resolutions
• L'objectif global de la session

Ce qui est naturellement perdu :

• La sortie exacte des commandes du debut de session
• Les etapes intermediaires verbeuses
• Les commandes exploratoires qui n'ont mene nulle part

Si vous devez faire reference a une sortie exacte d'un moment anterieur d'une longue session, envisagez d'exporter la session avant que la compaction ne se produise, ou demarrez une nouvelle session pour la tache suivante.

Suivi des tokens

YeePilot suit l'utilisation des tokens pour chaque session, vous donnant une visibilite sur la consommation d'API et les couts.

Consulter l'utilisation des tokens

Appuyez sur Ctrl+S pendant une session pour voir le panneau de statistiques, qui inclut :

• Tokens d'invite -- tokens envoyes a l'IA (vos messages plus le contexte)
• Tokens de completion -- tokens generes par l'IA
• Total des tokens -- utilisation combinee pour la session
• Cout estime -- calcule a partir de la tarification par token de votre modele

Comprendre les couts des tokens

L'utilisation des tokens varie considerablement en fonction de :

• La longueur de la conversation -- les sessions plus longues utilisent plus de tokens par message car l'historique complet est envoye comme contexte
• Le mode agent -- les taches multi-etapes consomment plus de tokens en raison du contexte repete et des appels d'outils
• Le mode de reflexion -- les niveaux de reflexion superieurs utilisent plus de tokens de completion
• Le contexte de fichiers -- les fichiers charges avec /file s'ajoutent au nombre de tokens d'invite

Reduire les couts

• Utilisez des modeles gratuits OpenRouter pour les taches de routine
• Demarrez de nouvelles sessions avec /new au lieu de poursuivre de tres longues conversations
• Retirez les fichiers du contexte avec /unfile lorsqu'ils ne sont plus necessaires
• Utilisez des modes de reflexion inferieurs (/think low) pour les taches simples
• Surveillez l'utilisation avec Ctrl+S regulierement

Stockage des sessions

Les sessions sont stockees localement dans ~/.yeepilot/sessions/. Chaque session est un fichier JSON contenant l'historique complet de la conversation et les metadonnees. Ces fichiers ne sont accessibles qu'a votre compte utilisateur.

Les sessions ne sont jamais envoyees aux serveurs de YeePilot. Elles restent entierement sur votre machine. Les seules donnees qui quittent votre systeme sont celles que vous envoyez a votre fournisseur IA choisi dans le cadre du flux normal de requete/reponse.

Flux de travail pratiques

Sessions par tache

Creez une nouvelle session pour chaque tache distincte :

> /new
> /rename firewall-audit-2026-02
> Verifier toutes les regles iptables et identifier les entrees trop permissives

Cela garde vos sessions organisees et les rend faciles a retrouver.

Reponse aux incidents

Pendant un incident, la session devient un journal en temps reel de votre investigation :

1. Demarrer une nouvelle session : /new
2. La nommer : /rename incident-2026-02-27-api-outage
3. Travailler sur le diagnostic avec YeePilot
4. Exporter une fois resolu : /export

La transcription exportee sert de rapport d'incident montrant exactement ce qui a ete verifie, ce qui a ete trouve et quelles actions ont ete prises.

Reprendre le travail

Revenir a une tache le lendemain :

> /sessions

Selectionnez la session pertinente. L'IA dispose du contexte complet de la conversation et peut reprendre la ou vous vous etiez arrete.