session-navigation

Par factory-ai · factory-plugins

Naviguer, rechercher et gérer les sessions Droid. À utiliser lorsque l'utilisateur souhaite : - Lister les sessions récentes - Rechercher dans l'historique des sessions des sujets ou patterns spécifiques - Reprendre une session précédente - Obtenir des détails sur ce qui a été accompli lors d'une session - Trouver des sessions par projet, date ou contenu

npx skills add https://github.com/factory-ai/factory-plugins --skill session-navigation

Navigation dans les sessions

Naviguer dans vos anciennes sessions Droid. Peut-être voulez-vous reprendre où vous vous étiez arrêté, retrouver ce que vous avez fait la semaine dernière, ou simplement voir ce qui s'est passé dans un projet.

Où vivent les sessions

Les sessions se trouvent dans ~/.factory/sessions/, organisées par dossier de projet. Chaque projet obtient son propre répertoire avec le chemin encodé (les slashes deviennent des tirets) :

~/.factory/sessions/
├── -Users-enoreyes-code-work-myapp/
│   ├── <uuid>.jsonl
│   └── <uuid>.settings.json
├── -Users-enoreyes-code-projects-api/
│   ├── <uuid>.jsonl
│   └── <uuid>.settings.json
└── ...

Deux fichiers par session :

La conversation (.jsonl) : Chaque ligne est un objet JSON. La première ligne contient les métadonnées (id de session, titre, répertoire de travail). Le reste est l'échange : messages utilisateur, réponses de l'assistant, appels d'outils.

Les paramètres (.settings.json) : Statistiques sur la session. Quel modèle, combien de temps elle a duré, comptages de tokens, mode autonomie.

Trouver des sessions

Lister les dossiers de projets

# Voir tous les dossiers de projets avec des sessions
ls ~/.factory/sessions/

# Trouver des dossiers pour un projet spécifique (correspondance partielle)
ls ~/.factory/sessions/ | grep "myapp"

Sessions récentes dans un projet

# Lister les sessions par date pour un projet
ls -lt ~/.factory/sessions/-Users-enoreyes-code-work-myapp/

# Obtenir les titres des sessions récentes
for f in $(ls -t ~/.factory/sessions/-Users-enoreyes-code-work-myapp/*.jsonl | head -10); do
  echo "=== $f ==="
  head -1 "$f" | jq -r '.title // "Untitled"'
done

Rechercher par contenu

# Rechercher dans TOUTES les sessions
rg "authentication" ~/.factory/sessions/

# Rechercher dans un projet spécifique
rg "bug fix" ~/.factory/sessions/-Users-enoreyes-code-work-myapp/

# Voir les correspondances en contexte
rg -C 2 "login" ~/.factory/sessions/-Users-enoreyes-code-projects-api/

Trouver quel projet a des sessions sur quelque chose

# Quels projets ont des sessions mentionnant "redis" ?
rg -l "redis" ~/.factory/sessions/ | cut -d'/' -f1-5 | sort -u

Lire une session

Une fois que vous avez trouvé un fichier de session :

# Les métadonnées (titre, répertoire de travail)
head -1 ~/.factory/sessions/-Users-enoreyes-code-work-myapp/<uuid>.jsonl | jq .

# Statistiques de session (modèle, tokens, durée)
cat ~/.factory/sessions/-Users-enoreyes-code-work-myapp/<uuid>.settings.json | jq .

# Combien de temps a duré cette conversation ?
wc -l ~/.factory/sessions/-Users-enoreyes-code-work-myapp/<uuid>.jsonl

Les messages utilisateur ont "role": "user", les réponses de l'assistant ont "role": "assistant". Les appels d'outils montrent quelles commandes ont été exécutées et quels fichiers ont été touchés.

Situations courantes

« Sur quoi ai-je travaillé dans ce projet ? » Listez le dossier de session de ce projet, vérifiez les dates, parcourez les fichiers de conversation.

« Trouver cette session où nous avons corrigé le bug de connexion » Recherchez « login » ou « auth » dans les sessions. Une fois trouvée, lisez la conversation.

« Reprendre ce que je faisais » Trouvez la session, parcourez ce qui s'est passé, résumez les décisions clés avant de continuer.

« Combien j'ai utilisé Droid ? » Les fichiers de paramètres contiennent les comptages de tokens et le temps actif. Additionnez les sessions si nécessaire.

Conseils

Utilisez rg (ripgrep) au lieu de grep. C'est plus rapide et gère mieux les dossiers imbriqués.

Les chemins de projets ont des slashes remplacés par des tirets. /Users/me/code/app devient -Users-me-code-app.

Le titre de la session n'est pas toujours utile. Parfois, vous devez lire la conversation pour savoir de quoi il s'agissait.

Les sessions peuvent contenir des informations sensibles. Soyez prudent sur ce que vous exposez.

Skills similaires