Гайд · TNWS AI
Как включить автодополнение Copilot CLI в Bash
Настройка tab completion GitHub Copilot CLI в Bash: текущая сессия, постоянная установка, проверка и безопасный откат.
Задача и когда применять
Практическая задача этого руководства — включить автодополнение подкоманд, опций и известных значений Copilot CLI в Bash сначала временно, затем постоянно. Материал рассчитан на разработчика или администратора, который уже установил GitHub Copilot CLI и хочет получить проверяемый результат, а не просто скопировать команду из справки.
Команды CLI исполняются в контексте текущего пользователя, рабочего каталога и активной политики организации. Перед началом сохраните вывод copilot version, pwd и git status --short, если работаете в репозитории. Не вставляйте в prompt, аргументы и диагностические файлы токены, закрытые ключи или содержимое .env.
Что подтверждено официально
Проверено 13 сентября 2026 года. copilot completion bash печатает shell-скрипт completion. Для текущей сессии GitHub показывает source <(copilot completion bash), для постоянной установки в Linux — copilot completion bash | sudo tee /etc/bash_completion.d/copilot.
Первоисточник — GitHub Copilot CLI command reference. Для MCP-сценария дополнительно используйте официальную настройку MCP servers. Цены, квоты и список доступных моделей здесь не приводятся: они не нужны для процедуры и могут меняться. Названия команд и параметров взяты из текущей официальной справки.
У CLI есть три разных уровня результата: команда может быть синтаксически принята, фактически выполнена и дать ожидаемый эффект. Проверяйте все три. Нулевой exit code без проверки файла или интерфейса недостаточен; красивый текст ответа при ненулевом exit code тоже нельзя считать успехом.
Перед тестом запишите точную гипотезу в одном предложении: «после команды появится такой-то файл, источник, запрет или набор подсказок». Затем определите независимый способ проверки, который не опирается на объяснение самого ассистента. Для файла это просмотр содержимого и diff, для разрешения — намеренно безопасная попытка запрещённого действия, для списка — сравнение структурированного вывода. Такой подход помогает обнаружить ситуацию, когда команда отработала, но не в том каталоге, не для того пользователя или не в той конфигурации.
Подготовка безопасной среды
Для первого запуска используйте тестовый репозиторий, временный каталог или read-only задачу. Сохраните baseline: существующие файлы конфигурации, список источников, текущий completion или разрешения. Если команда пишет файл, заранее определите точный путь и сделайте резервную копию только этого файла. Если команда предоставляет доступ, перечислите разрешённые и контрольные запрещённые объекты.
Не используйте глобальные разрешения ради удобства, когда задачу решает точный флаг. В CI разделяйте stdout, stderr и exit code. В интерактивной сессии читайте запросы разрешений и не подтверждайте действие только потому, что его предложил Copilot. Любой сгенерированный код или конфигурацию просматривайте как обычный внешний patch.
Пошаговые действия
- Убедитесь, что текущая оболочка — Bash:
printf "%s\n" "$BASH_VERSION". - Проверьте доступность CLI командой
copilot version. - Включите completion только для текущей сессии:
source <(copilot completion bash). - Наберите
copilotи нажмите Tab дважды; проверьте подкоманды без запуска опасной операции. - Просмотрите генерируемый скрипт через
copilot completion bash | less, прежде чем писать его с повышенными правами. - Для постоянной Linux-настройки выполните
copilot completion bash | sudo tee /etc/bash_completion.d/copilot. - Откройте новую Bash-сессию и повторите Tab-проверку.
- Для отката удалите созданный completion-файл административным способом и откройте новый shell.
После выполнения повторите диагностическую команду или откройте новую shell/CLI-сессию, если эффект должен пережить перезапуск. Сравните результат с baseline. Если изменилось больше файлов или источников, чем ожидалось, остановитесь, сохраните diff и выполните откат до продолжения.
Готовый шаблон для копирования
Заполните эту карточку перед изменением. Её можно вставить в issue или change request:
Проверка Bash completion
Shell: bash <версия>
Copilot CLI: <copilot version>
Временная команда: source <(copilot completion bash)
Тест: copilot <Tab><Tab>
Постоянный файл: /etc/bash_completion.d/copilot
Новая сессия проверена: да/нет
Откат проверен: да/нет
Дата проверки документации: 13.09.2026
Официальный источник: https://docs.github.com/en/copilot/reference/copilot-cli-reference/cli-command-reference
Для подготовки проверки можно скопировать prompt ниже. Он не разрешает ассистенту придумывать состояние окружения:
Составь план безопасной проверки команды GitHub Copilot CLI по карточке ниже.
Не выполняй запись, сетевую публикацию и изменение прав.
Не придумывай версию, файлы, exit code или успешный результат.
Верни: предпосылки, точную команду, позитивный тест, негативный тест,
наблюдаемые критерии успеха, откат и данные, которые нельзя логировать.
<вставьте заполненную карточку>
Реалистичный пример
Входные условия. На Linux CLI уже установлен, но copilot <Tab> не предлагает mcp, instruction и version. Пользователь сначала применяет source-команду.
Ожидаемый результат. В текущем Bash появляются подсказки. После записи официальной командой и открытия нового Bash автодополнение сохраняется; сам completion не выполняет выбранную команду.
Пример считается успешным только после наблюдаемой проверки: существования и содержимого файла, нового completion в отдельной сессии, записи JSON, списка источников либо явного запрета действия. Не подменяйте ожидаемый результат пересказом документации — зафиксируйте фактический вывод вашей среды.
Позитивный и негативный тест
В позитивном тесте используйте минимальный безопасный объект: одну известную подкоманду, один каталог, один источник или один JSONL-файл. Сначала предскажите наблюдаемый результат, затем запустите действие и сохраните exit code. Если вывод содержит внутренние пути, не публикуйте сырой лог.
Негативный тест должен менять ровно одно условие: запретить конкретную команду, выбрать файл вне scope, убрать сессионный флаг или открыть новый shell. Такой тест доказывает границу настройки. Не используйте production remote, реальные секреты и необратимые операции для демонстрации отказа.
Если позитивный тест не прошёл, проверьте working directory, кавычки shell, версию CLI, организационную policy и права на целевой путь. Если негативный тест неожиданно прошёл, считайте конфигурацию небезопасной, завершите сессию и сузьте разрешения.
Типичные ошибки
- Применять Bash-инструкцию в Zsh.
- Сразу использовать sudo без просмотра вывода.
- Ожидать сохранения временного
sourceпосле закрытия shell. - Тестировать нажатием Enter на незнакомой команде.
Отдельная ошибка — копировать команду между Bash, Zsh, Fish, PowerShell и CI без адаптации кавычек и перенаправлений. Сначала определите shell. Не сохраняйте секретные аргументы в history; используйте поддерживаемые переменные окружения или защищённое хранилище конкретной CI-системы.
Чек-лист финальной проверки
- copilot version и рабочий каталог записаны.
- Команда и названия флагов сверены с официальной документацией на 13.09.2026.
- В prompt, history и временных файлах нет секретов.
- Baseline сохранён до изменения.
- Позитивный тест дал заранее описанный наблюдаемый результат.
- Негативный тест подтвердил границу настройки.
- Проверены exit code, stdout и stderr, где это применимо.
- Неожиданные изменения файлов отсутствуют либо разобраны.
- Временные логи и конфигурации удалены или защищены.
- Откат выполнен на тесте или подробно записан.
FAQ
Нужен ли sudo для временного режима?
Нет. source <(...) действует в текущем процессе shell.
Почему после перезапуска всё исчезло?
Временный source не сохраняется; используйте постоянный completion-файл.
Что дополняется?
Подкоманды, опции и известные варианты значений опций.
Как откатить?
Удалите созданный файл из /etc/bash_completion.d и откройте новый Bash.
Итог
Рабочая настройка — это команда плюс доказательство её эффекта и границы. Храните заполненную карточку рядом с issue, а повторяемую команду — в проверенном wrapper script без секретов. Перед переносом в другую машину или организацию снова проверьте официальную справку: CLI обновляется, а доступность функций может зависеть от политики владельца Copilot.
Читайте также
Как добавить второй каталог в Copilot CLI через --add-dir
Безопасное использование --add-dir в GitHub Copilot CLI: доступ к файлам, доверенные skills/agents, относительные пути и проверка.
Как подключить MCP на одну сессию через --additional-mcp-config
Сессионное подключение MCP в Copilot CLI через --additional-mcp-config: JSON-файл, приоритет имени, проверка tools и очистка секретов.
Как получить JSONL из Copilot CLI через --output-format=json
Программный запуск Copilot CLI с -p и --output-format=json: поток JSONL, валидация строк, stderr, exit code и resume hint.
Комментарии
Пока тихо. Скажите первое слово