Использование GitHub Copilot CLI сессионных данных

Copilot CLI хранит данные с ваших CLI-сессий локально на вашем компьютере и по умолчанию синхронизирует сессии с вашим GitHub аккаунтом. Данные этих сессий позволяют вам:

• Возобновите предыдущие занятия и продолжайте с того места, где остановились.
• Используйте /chronicle команду «слэш» для создания стендап-отчетов, получения персонализированных советов и рекомендаций по улучшению вашего .github/copilot-instructions.md файла.
• Задавайте Copilot вопросы о ваших прошлых взаимодействиях.

В этой статье объясняется, как использовать эти функции из Copilot CLI. Для более глубокого изучения того, как хранятся и синхронизируются данные сессий, см. Сведения о GitHub Copilot данных сеанса. Для запроса ваших сессий из VS Code, см. Сессии управляющих агентов.

Возобновление предыдущей сессии

Вы можете возобновить предыдущую интерактивную сессию CLI либо из командной строки, либо во время активной сессии.

• Из командной строки запуститеcopilot --continue и продолжите последнюю сессию. Если хотите выбрать из списка недавних сессий, запустите copilot --resume откройте выбор сессий с перечислением ваших недавних сессий. Или, если вы знаете ID сессии, которую хотите возобновить, можно сразу copilot --resume SESSION-ID перейти к ней.

• Во время интерактивной сессии введите /resume , чтобы переключиться на другую сессию. Отображается picker, показывающий ваши недавние сессии. В качестве альтернативы можно сразу /resume SESSION-ID перейти к конкретной сессии.

Когда вы возобновляете сессию, Copilot загружайте полную историю разговоров, чтобы продолжить ровно с того места, где остановились.

Переименование сессии

Когда вы используете --resume командную строку или /resume команду слэш, отображаются ваши недавние сессии. Последний столбец списка показывает название сессии, что помогает определить сессию, которую вы хотите возобновить. Если у вас есть сессия, к которой вы часто возвращаетесь, возможно, стоит дать ей собственное название, чтобы её было проще найти в списке.

Чтобы восстановить сессию:

1. В интерактивной сессии, если вы хотите переименовать сессию, отличную от текущей, используйте /resume команду slash, чтобы переключиться на ту сессию, которую хотите переименовать.

2. Введите, /rename NEW_NAME чтобы переименовать текущую сессию. Вам не нужно добавлять имя в кавычки.

   Например: /rename Improve test coverage.

Совместная сессия

Содержимое текущего сеанса можно совместно использовать в качестве ссылки на сеанс GitHub.comв , файл Markdown, интерактивный HTML-файл или частный gist.GitHub.com Это позволяет делиться своими подсказками и Copilotответами с другими или хранить запись своей работы вне CLI.

Ввод /share без аргументов открывает полноэкранное меню общего доступа, в котором можно выбрать способ предоставления общего доступа к сеансу. Открытие этого меню не имеет общего доступа или экспорта ничего.

Чтобы предоставить общий доступ к GitHub сеансу и распечатать общую ссылку напрямую, введите следующее в интерактивном сеансе:

/share link

/share link

Чтобы прекратить общий доступ к сеансу, введите /share off.

Чтобы предоставить общий доступ к сеансу в качестве gist, введите следующее:

/share gist

/share gist

Чтобы экспортировать сессионный диалог в файл Markdown, введите:

/share file [PATH-TO-FILE]

/share file [PATH-TO-FILE]

Если вы не указываете путь к файлу, файл Markdown сохраняется в текущей рабочей директории с именем copilot-session-SESSIONID.md.

Чтобы экспортировать сеанс в виде интерактивного HTML-файла, введите следующее:

/share html [PATH-TO-FILE]

/share html [PATH-TO-FILE]

Как и при экспорте Markdown, если не указать путь к файлу, файл сохраняется в текущем рабочем каталоге с именем copilot-session-SESSIONID.html.

Если вы использовали команду косой /research черты в текущем сеансе, вы также можете использовать /share эту команду для совместного использования отчета исследования. Дополнительные сведения см. в разделе Исследования с GitHub Copilot CLI.

Использование /chronicle команды косой черты

/chronicle Команда slash предоставляет набор подкоманд, которые генерируют определённые типы инсайтов из истории вашей сессии. Хотя вы можете задавать Copilot свободные вопросы о своих сессиях в любое время, /chronicle подкоманды дают быстрый способ получить конкретные инсайты.

Когда вы вводите /chronicle без аргументов, отображается picker, позволяющий выбрать из доступных подкоманд:

Вы также можете вызвать подкоманду напрямую, не используя picker — например, /chronicle standup.

/chronicle standup

Это создаёт короткий отчёт на основе ваших Copilot CLI сессий, по умолчанию за последние 24 часа. Copilot Смотрит, над какими ветками вы работали, чего добились и какие GitHub pull requests или проблемы, которые вы упоминали. Он группирует выход по статусу завершения, при этом каждый элемент помечен своей веткой, и проверяет текущий статус связанных pull request.

Пример стендап-резюме

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

Вы можете добавить дополнительный контекст к команде для настройки результата. Например, можно использовать Copilot другой временной период, а не стандартные последние 24 часа:

/chronicle standup for the last 3 days

/chronicle standup for the last 3 days

/chronicle tips

Он анализирует ваши недавние сессии, чтобы понять, как вы работаете и как используете Copilot CLI. Затем он предоставляет 3–5 персонализированных рекомендаций. Copilot Он анализирует ваши реальные подсказки, используемые инструменты и функции, которые вы ещё не пробовали. Он сопоставляет это с полным набором доступных функций CLI — включая любых кастомных агентов и навыков, которые вы настроили в репозитории — чтобы найти возможности, которые вы могли упустить.

Советы основаны на ваших реальных данных о использовании, давая конкретные рекомендации, а не общие рекомендации.

Примеры советов

Ниже приведён пример основных моментов из /chronicle tips ответа. В реальных ответах каждый пункт объясняется более подробно.

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

Вы можете сосредоточить советы на конкретной области, добавив контекст после /chronicle tips. Рассмотрим пример.

/chronicle tips for better prompting

/chronicle tips for better prompting

/chronicle cost-tips

Он анализирует использование токенов за последние сессии, чтобы показать, куда они тратятся, и предлагает способы снижения затрат. Copilot Рассматривает закономерности, такие как длина запросов, частота вызовов инструментов и шаги продолжения, чтобы выявить возможности для более эффективного использования.

/chronicle cost-tips

/chronicle cost-tips

/chronicle search

Он ищет по всем вашим сессиям (не только в резюме) по конкретным ключевым словам или темам. В отличие от свободных вопросов, основанных на семантическом понимании, /chronicle search он выполняет прямой поиск по содержанию, что делает его полезным, когда вы знаете точный термин или тему, которую ищете.

/chronicle search authentication

/chronicle search authentication

/chronicle improve

Это глубокое погружение в историю вашей сессии, чтобы найти места, где Copilot было сложно дать желаемый ответ или результаты, или где пришлось корректировать курс, предоставляя дополнительные подсказки. На основе этого исследования предлагается улучшение вашего .github/copilot-instructions.md файла с пользовательскими инструкциями.

Получение специфических знаний по проекту в виде индивидуальных инструкций — мощный способ повысить Copilotпроизводительность работы над проектом. Дополнительные сведения см. в разделе Добавление пользовательских инструкций для GitHub Copilot CLI.

Copilot ищет сигналы трения — повторные сбои тестов, ошибки сборки, требующие многократных попыток, пользовательские сообщения, корректирующие или перенаправляющие агента, и шаблоны, повторяющиеся в разных сессиях. Затем он представляет 3–5 конкретных рекомендаций, каждая из которых объясняет найдённую проблему и инструкцию, которая её решит.

Например, Copilot вы можете обнаружить, что он неоднократно пытался использовать jest для вашего проекта использование vitest, или что он постоянно генерировал импорты в стиле, не соответствующем конвенциям вашей кодовой базы. Рекомендуемые инструкции предотвратят подобные ошибки в будущих сессиях.

После представления рекомендаций Copilot спросите, какие из них вы хотели бы применить. По умолчанию все рекомендации выбраны, но вы можете использовать стрелки на клавиатуре, чтобы перейти к любой из рекомендаций, а затем нажать пробел, чтобы отключить предложение. После выбора рекомендаций для применения нажмите Enter. Copilot затем создаёт или обновляет файл .github/copilot-instructions.md .

Задаю вопросы о вашей истории сессии

Вам не нужно использовать команду слэш, чтобы воспользоваться историей сессий. Если Copilot определит, что вы спрашиваете о вашем использовании CLI, он автоматически использует хранилище сессий для предоставления контекста ответа.

Вот несколько примеров вопросов, которые вы можете задать:

Инсайты о задачах

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 Проанализирую ваши разговоры, найдя случаи, когда первоначальный ответ не сопровождался соответствующими подсказками, а также случаи, когда были серии итеративных подсказок и ответов.

Сократить 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 Посмотрим на ваши шаблоны сессий — длину запросов, количество шагов продолжения и частоту вызова инструментов — и предложим способы добиться тех же результатов с меньшим числом взаимодействий.

Найдите свои самые продуктивные моменты

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 Буду запрашивать временные метки и результаты сессий, чтобы определить, когда ваши взаимодействия обычно наиболее эффективны.

Вспомните прошлые работы

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 Использует полнотекстовый поиск по истории сессий для поиска релевантных сессий, затем резюмирует выполненные действия.

Удаление сеансов

Самый простой способ удалить сессии — использовать /session команду слэш в интерактивной CLI-сессии.

• /session delete удаляет текущую сессию и начинает новую вместо неё.
• /session delete SESSION-ID удаляет конкретную сессию. Сначала показывается превью; --yes добавить, чтобы подтвердить, например /session delete SESSION-ID --yes.
• /session delete-all удаляет все ваши локальные сессии, кроме текущей. Добавьте --yes для подтверждения: /session delete-all --yes. Сессии, используемые другим процессом, пропускаются.
• /session prune --older-than DAYS удаляет сессии старше указанного количества дней. Добавьте --dry-run для предварительного просмотра, что будет удалено.
• /session cleanup Отображает сводку по хранилищу других локальных сеансов, сгруппированных по возрасту, и предлагает команды для удаления старых сеансов. Он не удаляет локальные или синхронизированные сеансы. Используйте /session prune --older-than DAYS --dry-run для предварительного просмотра удаления, а затем удалите --dry-run эти локальные сеансы.

Когда удаляете сессию, синхронизированную с вашим аккаунтом, /session delete спрашивают, хотите ли вы также удалить синхронизированную (удалённую) копию. Удаление синхронизированной копии также удаляет сессию из ваших /chronicle инсайтов и результатов запросов. Подкоманды /session delete-all и /session prune влияют только на локальные сессии и не удаляют синхронизированные данные. Чтобы удалить синхронизированные данные для этих сессий, вручную удалите их из GitHub.com.

Полный список /session подкоманд см. Справочник команды GitHub Copilot CLI.

Ручное удаление данных сессии

• Локальные данные: Чтобы локально удалить данные для конкретной сессии CLI, удалите соответствующую директорию сессии из ~/.copilot/session-state/. Чтобы очистить все данные локальной сессии, удалите всё под ~/.copilot/session-state/. После этого нужно вручную переиндексировать хранилище сессий. См. раздел «Переиндексирование хранилища сессий » позже в этой статье. Удаление локальных файлов не влияет на данные сессии, синхронизированные с вашим аккаунтом. Вы не можете локально удалить синхронизированные данные.
• Синхронизированные данные: вы можете удалить или скрыть синхронизированные сессии CLI из GitHub.com. Скрытие сессии удаляет её из индекса сессии, и она больше не отображается в результатах запроса. Удаление сессии удаляет её из вашего списка сессий на GitHub.com. Удаление применяется к сеансам из Copilot CLI, VS Codeа также GitHub Copilot app.

Реиндексация хранилища сессии

Хранилище сессий пополняется поэтапно во время сессии CLI. Данные для сессии записываются на диск в сессионно-специфическом подкаталоге .~/.copilot/session-state/ Это также происходит периодически во время сессии, а также после её окончания.

Можно переиндексировать хранилище сессий из файлов сессии на диске. Реиндексация также синхронизирует данные сессии с аккаунтом.

Ситуации, когда может понадобиться переиндексирование, включают:

• Индексация старых сессий: Если на диске есть старые файлы сессий, созданные до появления хранилища сессий, повторное индексирование заполнит хранилище сессий данными из этих сессий.
• Удаление сессии: Чтобы удалить сессию из вашей истории, используйте /session deleteкоманды , /session delete-all, или /session prune slash. Для синхронизированной сессии /session delete можно также удалить синхронизированную копию, что убирает сессию из ваших /chronicle инсайтов.
• Миграция/восстановление сессий: если вы перенесли файлы сессии на другой компьютер или восстановили их из резервной копии, не перемещая или не восстанавливая файл хранилища сессии (~/.copilot/session-store.db), вы можете воссоздать хранилище сессий с помощью команды reindex.
• Повреждение файла: если файл хранилища сессии (~/.copilot/session-store.db) повреждается или случайно удаляется, можно восстановить хранилище сессии из файлов сессии.
• Неожиданное завершение: Если сессия неожиданно завершается (например, из-за сбоя или отключения питания) до того, как данные, хранящиеся в памяти, были отправлены в хранилище сессии, вы можете заполнить хранилище сессии отсутствующими данными, если они были записаны на диск в файлах сессии до завершения.

Для переиндексирования хранилища сессий используйте следующую команду слэш в интерактивной CLI-сессии:

/chronicle reindex

/chronicle reindex

Дополнительные материалы

• Сведения о GitHub Copilot данных сеанса
• Сессии управляющих агентов
• Справочник команды GitHub Copilot CLI