Acerca de los datos de sesión de CLI de GitHub Copilot

CLI de Copilot registra cada sesión localmente. Puede reanudar sesiones anteriores, formular Copilot preguntas sobre las interacciones con la CLI y usar el /chronicle comando de barra diagonal para obtener información útil basada en sesión.

En este artículo

Introducción

Cada vez que use CLI de Copilot, un conjunto completo de datos sobre su sesión, incluidos sus mensajes, las respuestas de Copilot, las herramientas que se usaron y los detalles de los archivos modificados, se registran en su equipo local. Con el tiempo, esto crea un rico historial de en qué ha trabajado, cómo ha trabajado y qué Copilot ha hecho por usted.

Estos datos de sesión potencian varias características:

  •         **Reanudación de sesiones**: puede continuar donde lo dejó en cualquier sesión anterior.

  •         **Formular preguntas sobre tu historial**: Puede hacer preguntas a Copilot sobre su trabajo anterior, y este consultará los datos de la sesión para poder responderlas.

  •         **El `/chronicle` comando de barra diagonal**: un conjunto de subcomandos creados específicamente que generan informes de progreso, consejos personalizados y sugerencias para mejorar las instrucciones personalizadas, todas derivadas del historial de sesiones.

En este artículo conceptual se explica cómo se almacenan los datos de sesión y cómo puede aprovecharlos para mejorar el flujo de trabajo. Para obtener una guía práctica sobre cómo reanudar una sesión, preguntar a Copilot acerca de tus sesiones de CLI, y utilizar el comando slash /chronicle, consulta Uso de los datos de sesión de CLI de GitHub Copilot.

Cómo se almacenan los datos de sesión

Cada sesión de CLI de Copilot se conserva como un conjunto de archivos en el directorio ~/.copilot/session-state/ de tu máquina. Los datos de cada sesión contienen un registro completo de la sesión. Estos archivos le permiten reanudar una sesión interactiva de la CLI.

Además de los archivos de sesión, CLI de Copilot almacena datos de sesión estructurados en una base de datos de SQLite local, denominada almacén de sesiones. Estos datos son un subconjunto de los datos completos almacenados en los archivos de sesión. El almacén de sesiones es lo que impulsa el /chronicle comando de barra diagonal y también permite que Copilot responda a las preguntas que haga sobre el trabajo anterior.

Privacidad y localidad de datos

Todos los datos de sesión se almacenan localmente en el directorio principal y solo es accesible para su cuenta de usuario. Copilot lee estos datos en tu máquina cuando formulas preguntas sobre tus interacciones con el CLI, o cuando usas el /chronicle comando de barra. Los datos de sesión, como las indicaciones anteriores, los datos de contexto y las respuestas que recibió, se pueden enviar al modelo de IA, tal como lo harían en cualquier interacción normal CLI de Copilot .

Si desea quitar datos de una sesión determinada de la CLI, puede eliminar el directorio de sesión correspondiente de ~/.copilot/session-state/. Puede borrar todos los datos de sesión eliminando todo en ~/.copilot/session-state/. Después de hacerlo, debe volver a indexar manualmente el almacén de sesiones. Consulte Reindexación del almacén de sesiones más adelante en este artículo.

Acerca del comando slash de /chronicle

El comando /chronicle SUBCOMMAND utiliza los datos del almacén de sesiones para proporcionar información y sugerencias sobre tu uso de CLI de Copilot.

Puede escribir los siguientes comandos en una sesión interactiva de la CLI:

  •         `/chronicle standup`: genera un breve informe que resume lo que has trabajado en las sesiones recientes de la CLI, incluidos los nombres de rama, los enlaces de solicitudes de extracción y las comprobaciones de estado.

  •         `/chronicle tips`: proporciona consejos personalizados para usar CLI de Copilot de manera más eficaz.

  •         `/chronicle improve`: analiza el historial de sesiones para identificar patrones en los que Copilot puede haber malinterpretado su intención o donde hubo muchas interacciones de ida y vuelta, y genera instrucciones personalizadas para ayudar a Copilot a comprenderle mejor en el futuro.

  •         `/chronicle reindex`: reconstruye el almacén de sesiones basándose en los archivos del historial de sesión.

Ventajas de /chronicle y los datos de sesión

  •         **Flujo de trabajo de mejora automática**: el `improve` subcomando crea un bucle de comentarios que le ayuda a refinar las instrucciones personalizadas. Con el tiempo, esto hace que el agente sea más eficaz para su proyecto específico.

  •         **Informes diarios sin esfuerzo**: en lugar de reconstruir manualmente lo que hiciste ayer, `/chronicle standup` extrae un resumen a partir de tus datos reales de sesión.

  •         **Entrenamiento personalizado**: el `tips` subcomando actúa como un entrenador de productividad personal que sabe lo que CLI de Copilot puede hacer y cómo lo usa realmente. Puentea la brecha entre las características disponibles y el flujo de trabajo actual.

  •         **Hable con su historial de codificación**: el almacén de sesiones permite que Copilot responda a cualquier pregunta para la cual puedan ser útiles sus sesiones pasadas, desde recordar una corrección de errores que hizo la semana pasada hasta analizar sus patrones de solicitud a lo largo del tiempo.

  •         **Local y privado**: todos los datos de sesión (tanto los archivos JSONL sin procesar como el almacén de sesiones de SQLite) permanecen en el equipo. No se sube ni comparte nada más allá de las interacciones normales del modelo de IA que ocurren en cualquier sesión de CLI de Copilot. Tiene control total sobre los datos y puede eliminarlos en cualquier momento.

¿Cuándo debe usar estas características?

  •         **Al principio del día**: ejecute `/chronicle standup last 3 days` para generar un recordatorio de lo que ha trabajado recientemente y la sesión de la CLI en la que estaba trabajando.

  •         **Periódicamente, para mejorar**: ejecute `/chronicle tips` cada semana o dos para descubrir características y mejoras en el flujo de trabajo que podría no haber notado.

  •         **Cuando Copilot sigue cometiendo el mismo error**: ejecute `/chronicle improve` para identificar el patrón y generar instrucciones personalizadas para corregirlo.

  •         **Para recordar el trabajo pasado**: Pregunte una pregunta de forma libre como "¿He trabajado en cualquier cosa relacionada con la API de pagos?" y Copilot buscará en el historial.

  •         **Para continuar con el trabajo anterior**: use `copilot --continue` o `copilot --resume` para continuar donde lo dejó.

Volver a indexar el almacén de sesiones

El almacén de sesión se rellena incrementalmente durante una sesión CLI. Los datos de una sesión se escriben en el disco en un subdirectorio específico de la sesión de ~/.copilot/session-state/. Esto también sucede periódicamente durante una sesión y también cuando finaliza la sesión.

Puede reindexar la tienda de sesiones a partir de los archivos de sesión almacenados en disco, aunque normalmente nunca necesitará hacerlo.

Entre las situaciones en las que es posible que tenga que volver a indexar se incluyen las siguientes:

  •         **Indexación de sesiones antiguas**: si tiene archivos de sesión antiguos en el disco que se crearon antes de que existiera el almacén de sesiones, la reindexación rellenará el almacén de sesiones con datos de esas sesiones.

  •         **Eliminación de** sesión: si desea eliminar una sesión del historial, puede eliminar el directorio de sesión y, a continuación, volver a indexar el almacén de sesiones.

  •         **Migración o recuperación de sesiones**: si movió los archivos de sesión a otra máquina o los restauró desde una copia de seguridad, sin mover o restaurar el archivo de almacén de sesiones (`~/.copilot/session-store.db`), puede usar el comando reindex para volver a crear el almacén de sesiones.

  •         **Corrupción de archivos**: si el archivo de almacén de sesión (`~/.copilot/session-store.db`) se corrompe o se elimina accidentalmente, puede recuperar el almacén de sesiones a partir de los archivos de sesión.

  •         **Terminación inesperada**: si una sesión finaliza inesperadamente (por ejemplo, debido a una pérdida de energía o bloqueo) antes de que los datos mantenidos en la memoria se hayan vaciado en el almacén de sesiones, es posible que pueda rellenar el almacén de sesiones con los datos que faltan si se escribió en el disco, en los archivos de sesión, antes de la finalización.

Para volver a indexar el almacén de sesiones, use el siguiente comando de barra diagonal en una sesión interactiva de la CLI:

Copilot prompt
/chronicle reindex

Lectura adicional

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

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