Использование интерфейса командной строки GitHub Copilot

Интерфейс командной строки (CLI) для GitHub Copilot позволяет использовать Copilot непосредственно из терминала. Дополнительные сведения см. в разделе Сведения о интерфейсе командной строки GitHub Copilot.

Примечание.

GitHub Copilot CLI находится в общедоступной предварительной версии и подлежит изменению.

Предварительные требования

Установите Copilot CLI. См . раздел AUTOTITLE.

Использование Copilot CLI

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

Copilot попросит подтвердить, что вы доверяете файлам в этой папке.

Внимание

Во время этого сеанса GitHub Copilot CLI Copilot может попытаться считывать, изменять и выполнять файлы под этой папкой. Вы должны продолжать работу только в том случае, если вы доверяете файлам в этом расположении. Дополнительные сведения о доверенных каталогах см. в разделе Сведения о интерфейсе командной строки GitHub Copilot.
Выберите один из вариантов:

1. Да, продолжайте:

Copilot может работать с файлами в этом расположении только для этого сеанса.

2. Да, и запомните эту папку для будущих сеансов:

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

3. Нет, выход (ESC):

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

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

Примеры запросов см. в разделе Сведения о интерфейсе командной строки GitHub Copilot.
Если Copilot хочет использовать средство, которое может изменять или выполнять файлы — например, , touch, chmod``nodeилиsed, он попросит утвердить использование средства.

Выберите один из вариантов:

1. Да:

Разрешить Copilot использовать это средство. При следующем использовании этого средства Copilot будет попросить вас утвердить его еще раз.

2. Да, а затем утвердите TOOL для остальной части выполняемого сеанса:

Разрешить Copilot использовать это средство ( с любыми параметрами) без запроса еще раз для остальной части текущего сеанса. Вам придется снова утвердить команду в будущих сеансах.

Выбор этого параметра полезен для многих инструментов, таких как , так как chmodне требуется утверждать аналогичные команды многократно в одном сеансе. Однако следует учитывать последствия безопасности этого параметра. Выбор этого параметра для команды rm, например, позволит Copilot удалить любой файл в текущей папке или ниже, не запрашивая утверждение.

3. Нет, и сообщите Copilot, что делать по-другому (Esc):

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

Например, если вы попросите Copilot создать скрипт bash, но не хотите использовать скрипт Copilot предлагает, можно остановить текущую операцию и ввести новый запрос, например: Continue the previous task but include usage instructions in the script

Советы

Оптимизируйте работу с Copilot CLI со следующими советами.

Остановка выполняемой в настоящее время операции

Если вы введете запрос, а затем решите, что вы хотите остановить Copilot от завершения задачи в то время как она по-прежнему называется "Мышление", нажмите клавишу ESC.

Добавление определенного файла в запрос

Чтобы добавить определенный файл в запрос, используйте @ относительный путь к файлу. Пример: Explain @config/ci/ci-required-checks.yml или Fix the bug in @src/app.js. Это добавляет содержимое файла в запрос в качестве контекста для Copilot.

При вводе пути к файлу соответствующие пути отображаются под полем запроса. Используйте клавиши со стрелками, чтобы выбрать путь и нажать клавишу TAB , чтобы завершить путь в запросе.

Работа с файлами в другом расположении

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

Вы также можете добавить доверенный каталог вручную с помощью команды косой черты:

/add-dir /path/to/directory

Если все файлы, с которыми вы хотите работать, находятся в другом расположении, можно переключить текущий рабочий каталог без запуска нового сеанса Copilot CLI с помощью команды косой черты:

/cwd /path/to/directory

Возобновление интерактивного сеанса

Вы можете вернуться к предыдущему интерактивному сеансу и продолжить беседу с Copilot, используя --resume параметр командной строки, а затем выбрать сеанс, который вы хотите возобновить из отображаемого списка.

Использование пользовательских инструкций

Вы можете повысить производительность Copilot, добавив пользовательские инструкции в репозиторий, в который вы работаете. Пользовательские инструкции — это описания естественного языка, сохраненные в файлах Markdown в репозитории. Они автоматически включаются в запросы, которые вы вводите во время работы в этом репозитории. Это помогает Copilot лучше понять контекст проекта и как реагировать на запросы.

Copilot CLI поддерживает:

Инструкции по всему репозиторию .github/copilot-instructions.md в файле.
Файлы инструкций для конкретного пути: .github/copilot-instructions/**/*.instructions.md
Файлы агента, такие как AGENTS.md.

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

Добавление сервера MCP

Copilot CLI поставляется с уже настроенным сервером MCP GitHub MCP. Этот сервер MCP позволяет взаимодействовать с ресурсами на GitHub.com, например, что позволяет объединять запросы на вытягивание из ИНТЕРФЕЙСА командной строки.

Чтобы расширить функциональные возможности, доступные для вас в Copilot CLI, можно добавить дополнительные серверы MCP:

Используйте следующую команду косой черты:
```
/mcp add
```
Введите сведения о сервере MCP, который вы хотите добавить, с помощью клавиши TAB для перемещения между полями.
Нажмите клавиши CTRL+S, чтобы сохранить сведения.

Сведения о настроенных серверах MCP хранятся в mcp-config.json файле, расположенном по умолчанию в каталоге ~/.config . Это расположение можно изменить, задав XDG_CONFIG_HOME переменную среды. Сведения о структуре JSON определения сервера см. в разделе Расширение агента кода GitHub Copilot с помощью протокола контекста модели (MCP).

Подробнее

Полный список параметров командной строки и команд косой черты, которые можно использовать с Copilot CLI, выполните одно из следующих действий:

Введите ? поле запроса в интерактивном сеансе.
Введите copilot help в терминале.

Дополнительные сведения используют одну из следующих команд в терминале:

Параметры конфигурации:

copilot help config

Параметры конфигурации можно настроить, изменив config.json файл, расположенный по умолчанию в каталоге ~/.config . Это расположение можно изменить, задав XDG_CONFIG_HOME переменную среды.
Переменные среды, влияющие на Copilot CLI:

copilot help environment
Доступные уровни ведения журнала:

copilot help logging
**** Разрешения для разрешения или запрета использования средства:

copilot help permissions

Обратная связь

Если у вас есть отзывы о GitHub Copilot CLI, сообщите нам, используя /feedback команду косой черты в интерактивном сеансе и выбрав один из вариантов. Вы можете выполнить частный опрос отзывов, отправить отчет об ошибке или предложить новую функцию.