Каждая команда youka принимает один и тот же набор глобальных флагов. Они управляют режимом вывода, обработкой ввода, поведением ожидания и целевым API.
Flags
JSON envelope
С --json CLI выводит ровно один конверт в stdout и ничего больше.
Успех:
Ошибка:
Коды завершения:
Пропустите конверт через jq для скриптинга: youka project show $ID --json | jq '.data.state'.
Передача JSON-тел
Любая команда создания или обновления принимает --body для полного тела запроса. Используйте его вместо экранирования большого JSON в командной строке.
Ожидание асинхронных задач
--wait опрашивает созданный ресурс за вас и возвращает финальное состояние. Без --wait команды возвращаются сразу после постановки задачи в очередь.
В скриптах используйте --wait вместе с --quiet, чтобы скрыть прогресс-бар, но при этом всё равно вывести JSON-результат.
Идемпотентность
Передавайте --idempotency-key, чтобы команды записи было безопасно повторять. Повторное использование одного и того же ключа с тем же payload возвращает исходный результат вместо создания дубликата.
Используйте ключи идемпотентности всякий раз, когда агент может повторить запрос после таймаута.
Переменные окружения
Что дальше
- Account - сохраните ваш API-ключ
- Projects - ваш первый автоматизированный workflow
- AI agents - правила работы для авторов агентов
