Uso de GitHub Copilot CLI datos de sesión

Reanude las sesiones anteriores Copilot CLI , use el /chronicle comando de barra diagonal para obtener información del historial de sesiones y formular Copilot preguntas sobre el uso de la CLI.

En este artículo

Copilot CLI almacena los datos de las sesiones de la CLI localmente en el equipo y, de forma predeterminada, sincroniza las sesiones con su GitHub cuenta. Estos datos de sesión le permiten:

  • Reanude las sesiones anteriores y continúe justo donde lo dejó.
  • Use el comando de barra oblicua /chronicle para generar informes de soporte técnico, obtener sugerencias personalizadas y recibir sugerencias para mejorar el archivo .github/copilot-instructions.md.
  • Haz Copilot preguntas sobre tus interacciones pasadas.

En este artículo se explica cómo usar estas características desde Copilot CLI. Para obtener más información sobre cómo se almacenan y sincronizan los datos de sesión, consulte Acerca de los datos de sesión de GitHub Copilot. Para consultar las sesiones desde VS Code, consulte Gestión de sesiones del agente.

Reanudación de una sesión anterior

Puede reanudar una sesión de la CLI interactiva anterior desde la línea de comandos o durante una sesión activa.

  • En la línea de comandos, ejecute copilot --continue para reanudar la sesión más reciente. Si desea elegir entre una lista de sesiones recientes, ejecute copilot --resume para abrir un selector de sesión que muestre las sesiones recientes. Como alternativa, si conoce el identificador de sesión de la sesión que desea reanudar, puede ejecutar copilot --resume SESSION-ID para ir directamente a ella.

  • Durante una sesión interactiva, escriba /resume para cambiar a otra sesión. Se muestra un selector donde aparecen las sesiones recientes. Como alternativa, puede entrar /resume SESSION-ID para ir directamente a una sesión específica.

Nota:

Puede encontrar el identificador de una sesión interactiva actual mediante el /session comando de barra diagonal. El identificador de sesión también se muestra al salir de una sesión interactiva.

Cuando reanuda una sesión, Copilot carga el historial de conversaciones completo, por lo que puede continuar exactamente donde lo dejó.

Cambiar el nombre de una sesión

Cuando se usa la opción de --resume línea de comandos o el /resume comando de barra diagonal, se muestran las sesiones recientes. La columna final de la lista muestra el nombre de la sesión, que le ayuda a identificar la sesión que desea reanudar. Si tiene una sesión a la que vuelve con frecuencia, es posible que quiera asignarle un nombre personalizado para facilitar la búsqueda en la lista.

Para renombrar una sesión:

  1. En una sesión interactiva, si desea cambiar el nombre de una sesión distinta de la sesión actual, use el /resume comando de barra diagonal para cambiar a la sesión a la que desea cambiar el nombre.

  2. Escriba /rename NEW_NAME para cambiar el nombre de la sesión actual. No es necesario incluir el nombre entre comillas.

    Por ejemplo: /rename Improve test coverage.

Uso compartido de una sesión

Puede compartir el contenido de la sesión actual como un vínculo que se puede compartir con la sesión en GitHub.com, un archivo Markdown, un archivo HTML interactivo o un gist privado en GitHub.com. Esto le permite compartir tus solicitudes y las respuestas de Copilot con otros, o almacenar un registro de su trabajo fuera de la CLI.

Nota:

Puede usar /export como alias para /share en cualquiera de los comandos siguientes.

Para compartir la sesión GitHub e imprimir un vínculo que se pueda compartir, escriba lo siguiente en una sesión interactiva:

Copilot prompt
/share

Para dejar de compartir la sesión, escriba /share off.

Para compartir una sesión como un gist, escriba:

Copilot prompt
/share gist

Para exportar la conversación de sesión como un archivo Markdown, escriba:

Copilot prompt
/share file [PATH-TO-FILE]

Si no especifica una ruta de acceso de archivo, el archivo Markdown se guarda en el directorio de trabajo actual con el nombre copilot-session-SESSIONID.md.

Nota:

Los Gists no están disponibles para Enterprise Managed Users, o si usa GitHub Enterprise Cloud con residencia de datos (*.ghe.com).

Para exportar la sesión como un archivo HTML interactivo, escriba:

Copilot prompt
/share html [PATH-TO-FILE]

Al igual que con la exportación de Markdown, si no especifica una ruta de acceso de archivo, el archivo se guarda en el directorio de trabajo actual, con el nombre copilot-session-SESSIONID.html.

Si ha usado el /research comando de barra diagonal en la sesión actual, también puede usar el /share comando para compartir un informe de investigación. Para obtener más información, vea Investigación con GitHub Copilot CLI.

Usar el comando de barra diagonal /chronicle

El /chronicle comando de barra diagonal proporciona un conjunto de subcomandos que generan tipos específicos de información a partir del historial de sesiones. Aunque puede formular Copilot preguntas de forma gratuita sobre las sesiones en cualquier momento, /chronicle los subcomandos proporcionan una manera rápida de obtener información específica.

Al escribir /chronicle sin argumentos, se muestra un selector que le permite elegir entre los subcomandos disponibles:

SubcommandDescription
standupGenere un informe de actualización diario a partir del trabajo reciente.
tipsObtenga sugerencias personalizadas en función de los patrones de uso.
cost-tipsObtenga comentarios sobre el gasto de tokens y sugerencias para reducir los costos.
searchBusque en el historial de sesiones temas o palabras clave específicos.
improveSugiere mejoras para tu archivo de instrucciones personalizado Copilot.
reindexRecompile el almacén de sesiones local desde el historial de sesiones y sincronice los datos de sesión en su cuenta.

También puede invocar un subcomando directamente, sin usar el selector, por ejemplo, /chronicle standup.

/chronicle standup

Esto genera un informe corto basado en tus sesiones Copilot CLI, por defecto de las últimas 24 horas. Copilot examina en qué ramas ha trabajado, lo que ha logrado y las GitHub solicitudes de incorporación de cambios o incidencias a las que hace referencia. Agrupa los resultados por estado de finalización, con cada elemento identificado por su rama y comprueba el estado actual de cualquier solicitud de incorporación de cambios vinculada.

Resumen de standup de ejemplo

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

Puede anexar contexto adicional al comando para personalizar la salida. Por ejemplo, puede indicarle Copilot que use un período de tiempo diferente, en lugar de las últimas 24 horas predeterminadas:

Copilot prompt
/chronicle standup for the last 3 days

/chronicle tips

Esto analiza tus sesiones recientes para comprender cómo tú trabajas y cómo usas Copilot CLI. A continuación, proporciona recomendaciones personalizadas de 3 a 5. Copilot examina las solicitudes reales, las herramientas que usa y las características que aún no ha probado. Lo compara con el conjunto completo de funciones de la interfaz de línea de comandos (CLI) disponibles —incluidos los agentes y capacidades personalizados que haya configurado en el repositorio— para detectar oportunidades que podría estar pasando por alto.

Las sugerencias se basan en los datos de uso reales, lo que proporciona sugerencias específicas en lugar de consejos genéricos.

Sugerencias de ejemplo

A continuación se muestra un ejemplo de los puntos principales de una /chronicle tips respuesta. En una respuesta real, cada punto se explica con más detalle.

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

Puede centrar las sugerencias en un área específica anexando el contexto después de /chronicle tips. Por ejemplo:

Copilot prompt
/chronicle tips for better prompting

/chronicle cost-tips

Esto analiza el uso del token en las sesiones recientes para mostrar dónde se invierten los tokens y sugiere formas de reducir los costos. Copilot examina patrones como la longitud de la instrucción, la frecuencia de llamadas a herramientas y los pasos de continuación para identificar oportunidades para un uso más eficiente.

Copilot prompt
/chronicle cost-tips

Esto busca en todo el contenido de la sesión (no solo resúmenes) para palabras clave o temas específicos. A diferencia de las preguntas de forma libre que se basan en la comprensión semántica, /chronicle search realiza una búsqueda directa de contenido, lo que lo hace útil cuando conoce el término exacto o el tema que busca.

Copilot prompt
/chronicle search authentication

/chronicle improve

Esto analiza en profundidad el historial de su sesión para identificar los momentos en los que Copilot tuvo dificultades para ofrecer el tipo de respuesta o resultados que buscaba, o en los que tuvo que corregir el rumbo proporcionando indicaciones de seguimiento. Sobre la base de esta investigación, sugiere mejoras en el archivo de instrucciones personalizado .github/copilot-instructions.md.

La captura de conocimientos específicos del proyecto como instrucciones personalizadas es una manera eficaz de mejorar el rendimiento de Copilot al trabajar en tu proyecto. Para obtener más información, vea Adición de instrucciones personalizadas para GitHub Copilot CLI.

Nota:

A diferencia de otras veces, Copilot usa los datos de sesión para responder preguntas o generar información, el ámbito del subcomando improve se limita a los datos del repositorio actual o del directorio de trabajo. Esto garantiza que las recomendaciones son relevantes para el proyecto en el que está trabajando actualmente.

Copilot busca señales de fricción: errores de prueba repetidos, errores de compilación que requerían varios intentos, mensajes de usuario que corrigieron o redirigieron el agente y patrones que se repiten en las sesiones. A continuación, presenta recomendaciones específicas de 3 a 5, cada una explicando el problema que encontró y la instrucción que lo abordaría.

Por ejemplo, Copilot podría encontrar que intentó usar jest repetidamente para el proyecto que usa vitesto que seguía generando importaciones en un estilo que no coincide con las convenciones de código base. Las instrucciones sugeridas evitarían estos errores en sesiones futuras.

Después de presentar sus recomendaciones, Copilot pregunta cuáles le gustaría aplicar. De forma predeterminada, se seleccionan todas las recomendaciones, pero puede usar las teclas de dirección del teclado para pasar a cualquiera de las recomendaciones y, a continuación, presionar la barra espaciadora para desactivar la sugerencia. Después de elegir qué recomendaciones aplicar, presione Entrar. Copilot a continuación, crea o actualiza el .github/copilot-instructions.md archivo.

Formular preguntas sobre el historial de sesiones

No es necesario usar un comando de barra oblicua para sacar partido del historial de sesiones. Si Copilot determina que está preguntando sobre el uso de la CLI, usará automáticamente el almacén de sesiones para proporcionar el contexto de una respuesta.

Nota:

De forma predeterminada, las respuestas a preguntas sobre las interacciones con Copilot CLI se basan en todas las sesiones grabadas, independientemente del repositorio o rama en la que esté trabajando actualmente.

Estos son algunos ejemplos de los tipos de preguntas que podría formular:

Información sobre las tareas

Copilot prompt
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 analizará las conversaciones, buscará tiempos en los que una respuesta inicial no fue seguida de avisos relacionados y horas en las que se produjo una serie de mensajes iterativos y respuestas.

Reducir el uso de GitHub AI Credits

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

Copilot observará los patrones de sesión (longitud del aviso, número de pasos de continuación y frecuencia de llamada de herramienta) y sugerirá formas de lograr los mismos resultados con menos interacciones.

Encuentra tus momentos más productivos

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

Copilot consultará las marcas de tiempo y los resultados de la sesión para identificar cuándo las interacciones tienden a ser más eficaces.

Recordar trabajo pasado

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

Copilot usa la búsqueda de texto completo en el historial de sesiones para buscar sesiones pertinentes y, a continuación, resume lo que ha hecho.

Eliminación de sesiones

La manera más sencilla de eliminar sesiones es usar el comando de barra diagonal en una sesión interactiva de la /session CLI.

  • /session delete elimina la sesión actual e inicia una nueva en su lugar.
  • /session delete SESSION-ID elimina una sesión específica. Esto muestra primero una vista previa; agregue --yes para confirmar, por ejemplo /session delete SESSION-ID --yes.
  • /session delete-all elimina todas las sesiones locales excepto la actual. Agregue --yes para confirmar: /session delete-all --yes. Se omiten las sesiones que están en uso por otro proceso.
  • /session prune --older-than DAYS elimina las sesiones anteriores al número de días especificado. Añada --dry-run para ver en vista previa lo que se eliminaría.

Cuando se elimina una sesión que se ha sincronizado con su cuenta, /session delete se pregunta si también desea eliminar la copia sincronizada (remota). Al eliminar la copia sincronizada, también se elimina la sesión de tus /chronicle estadísticas y de los resultados de la consulta. Los /session delete-all subcomandos y /session prune solo afectan a las sesiones locales y no eliminan los datos sincronizados. Para quitar los datos sincronizados de esas sesiones, elimínelo manualmente de GitHub.com.

Para obtener la lista completa de /session subcomandos, consulte Referencia de comandos de la CLI de GitHub Copilot.

Eliminación manual de datos de sesión

  • Datos locales: para quitar datos de una sesión de la CLI determinada localmente, elimine el directorio de sesión correspondiente de ~/.copilot/session-state/. Para borrar todos los datos de sesión local, elimine 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. La eliminación de archivos locales no afecta a los datos de sesión que se han sincronizado con su cuenta. No se pueden eliminar los datos sincronizados localmente.
  • Datos sincronizados: puede eliminar u ocultar las sesiones de la CLI sincronizadas de GitHub.com. Ocultar una sesión lo quita del índice de sesión para que ya no aparezca en los resultados de la consulta. Al eliminar una sesión, se elimina de tu lista de sesiones en GitHub.com. La eliminación afecta a las sesiones de CLI, VS Code y GitHub Copilot app.

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 volver a indexar el almacén de sesiones desde los archivos de sesión en el disco. La reindexación también sincroniza los datos de sesión con su cuenta.

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: para eliminar una sesión del historial, use los /session deletecomandos de barra diagonal , /session delete-allo /session prune . En una sesión sincronizada, /session delete también puede eliminar la copia sincronizada, lo que elimina la sesión de tu /chronicle panel de información.
  • 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