Справочник по CLI

lizard CLI — это основной интерфейс платформы. Эта страница охватывает установку, глобальные флаги, коды выхода и автоматическое обнаружение. У каждой команды есть собственная справочная страница в боковой панели — см. lizard up, lizard service, lizard secrets и остальные.

Справочник сгенерирован для CLI v0.3.62. Выполните lizard <cmd> --help --json для получения точной схемы, соответствующей версии, для любой команды.

Установка и обновление

npm install -g @lizard-build/cli
lizard --version
lizard upgrade            # update to the latest version
lizard upgrade --check    # check without installing

Всегда используйте глобально установленный бинарный файл lizard — не npx. См. Быстрый старт для исправления ошибок доступа.

Аутентификация

lizard login                  # browser OAuth
lizard login --token lzd_xxx  # token auth
lizard logout
lizard whoami                 # current user, workspace, linked project

В CI задайте LIZARD_TOKEN в переменных окружения вместо запуска login.

Глобальные флаги

Большинство команд также принимают -p, --project, -s, --service и -w, --workspace для обращения к конкретному ресурсу вместо связанного.

Коды выхода

Автоматическое обнаружение

CLI является самодокументирующимся. Чтобы увидеть полное дерево команд, глобальные флаги и коды выхода:

lizard --help --json

Для точных аргументов и опций любой команды или подкоманды:

lizard <cmd> --help --json
lizard <cmd> <sub> --help --json     # e.g. lizard service set --help --json

Это всегда отражает вашу установленную версию — используйте это вместо угадывания формата флагов. Так агент узнаёт CLI без обучения на нём: см. развёртывание из Claude Code.

Конфигурация и состояние

• CLI хранит аутентификацию и ссылку на проект текущей директории в ~/.lizard/config.json.
• lizard status показывает ссылку на рабочую область/проект/сервис текущей директории (аутентификация не требуется).
• lizard config apply применяет файл lizard-config.json к проекту (используйте --dry-run для предварительного просмотра).

Тома Sandbox

Управляйте Persistent Volumes по имени в пределах проекта:

lizard volume create agent-workdir --size 10 --project proj_123
lizard volume list --project proj_123
lizard sandbox create --volume agent-workdir --project proj_123

Имена уникальны в проекте: строчные латинские буквы, цифры и дефисы, до 64 символов; первая и последняя позиция — буква или цифра. Новые тома принимают целые GB от 1 до 50, по умолчанию 5. CLI читает текущие ограничения сервера перед созданием тома и учитывает изменения настроек. Существующие тома большего размера сохраняют размер.

После отключения тома команда lizard volume rm agent-workdir --project proj_123 удаляет его и данные. volume list показывает имена; --json включает сгенерированные ID.