Справочник командной строки удобнее читать не сплошным списком, а по разделам: глобальные параметры, корневые команды, управление внешними серверами, песочница, серверный исполнитель и параметры отдельных команд. Такое деление отражает устройство инструмента: одни параметры действуют на любой запуск, другие имеют смысл только внутри своей команды. Разница не косметическая. Глобальный параметр, однажды прописанный в алиасе оболочки или в переменной окружения, будет действовать во всех запусках, включая те, о которых вы в тот момент не думали. Параметр команды остаётся там, где написан, и потому безопаснее.

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

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

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

При работе со справочником полезно держать в голове разделение на то, что влияет на границы, и то, что влияет на удобство. Параметры автономности, песочницы и доверия относятся к первому классу: их значения меняют, что агент может сделать. Параметры вывода, модели и продолжения сессии - ко второму. Отдельно стоит запомнить неинтерактивный режим печати ответа: он задуман для скриптов, но при этом располагает всеми инструментами, включая запись файлов и запуск команд оболочки. Сам по себе он ничего не ограничивает, и границы для него задают теми же параметрами, что и для интерактивной работы.