Справочник CLI

Группы команд bounc, аутентификация, глобальные флаги, машинный вывод и коды выхода.

CLI bounc покрывает большую часть того, что умеет веб-приложение: задачи и проекты, агенты и скиллы, команды, автопилоты, воркфлоу, таблицы Активов, рантаймы и вложения. Здесь — карта групп команд и то, что действует глобально; исчерпывающий список подкоманд и флагов всегда доступен через --help.

Установка

CLI — один самодостаточный бинарный файл. Скачайте его со страницы /download веб-приложения (она подберёт сборку под вашу ОС), сделайте исполняемым и положите в PATH:

chmod +x bounc          # на Windows скачивается bounc.exe
./bounc login

Обновление — bounc self-update: проверяет канал релизов и заменяет бинарник на месте.

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

bounc login                     # вход через браузер
bounc login --token bnp_…       # без браузера: готовый персональный токен
bounc auth status               # кто я, какое пространство, какой профиль
bounc auth logout               # стереть локальный токен

bounc login сохраняет персональный токен доступа (bnp_) в локальный профиль, и дальше им аутентифицируется каждая команда. Для CI и headless-машин выпустите токен в Настройках → Токены и передайте его флагом --token.

BOUNC_TOKEN и BOUNC_WORKSPACE_ID из окружения важнее сохранённого входа. Агент вашим CLI не пользуется: в своём ходе он работает через инструменты Баунса с пропуском хода, и его действия приписываются ему. См. Токены.

Несколько окружений держатся в профилях: bounc profile переключает их, bounc config читает и пишет локальные настройки, bounc workspace switch меняет рабочее пространство по умолчанию для команд.

Работа и данные

Команда	Что внутри
`bounc issue`	`create` `list` `show` `update` `status` `assign` `move` `search` `delete`, плюс группы `comment`, `label`, `subscriber`, `metadata`, `children`, `runs`, `run-messages`
`bounc project`	CRUD, статус, поиск; группа `resources`
`bounc initiative`	CRUD и привязка проектов
`bounc label`	CRUD меток рабочего пространства
`bounc dataset`	Таблицы Активов: `create` `list` `show` `update` `import` `archive` `restore` `delete`, плюс группы `field`, `record`, `view`
`bounc diagram`	Диаграммы Активов: `create` `list` `show` `update` `home` `archive` `restore` `delete`; `--mermaid <файл>` принимает и `-` (stdin)
`bounc attachment`	`list` `get` `data` `upload` `delete` для вложений задач и комментариев

Команды list печатают короткие идентификаторы, готовые к копированию: ключи задач вида ACME-123 и короткие префиксы для остального. Любая последующая команда принимает и короткий идентификатор, и полный UUID.

Агенты и автоматизация

Команда	Что внутри
`bounc agent`	`create` `create-from-template` `list` `show` `update` `archive` `restore` `templates` `template`, плюс группа `skills`
`bounc skill`	`create` `list` `show` `update` `delete` `search` `import` `builtins`, плюс группа `files`
`bounc team`	`create` `list` `show` `update` `members` `briefing` `archive` `restore`
`bounc autopilot`	`create` `list` `show` `update` `delete` `trigger`, плюс группы `triggers`, `runs`, `deliveries`
`bounc workflow`	`create` `list` `show` `nodes` `export` `apply` `diff` `set-draft` `validate` `plan` `publish` `start` `cancel` `rerun`

Инфраструктура и профиль

Команда	Что внутри
`bounc runtime`	`list` `show` `update` `delete` `usage`
`bounc daemon`	`connect` `start` `stop` `restart` `status` `logs` для локального демона; `connect` подключает этот компьютер к рабочему пространству после `bounc login`
`bounc workspace`	`list` `get` `switch`, плюс группа `member`
`bounc user`	Собственный профиль
`bounc schema`	Интроспекция модели данных по OpenAPI: `list` `describe` `search`
`bounc version` · `bounc self-update`	Версия и обновление бинарника

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

Действуют на любой команде:

Флаг	Назначение
`--output <text\|json>`	Формат вывода; `json` пригоден для машинной обработки
`--fields <paths>`	Вместе с `--output json`: проекция ответа на точечные пути — `id,title,assignee.name`
`--dry-run`	Проверить ввод и разрешить ссылки, затем показать несостоявшийся запрос вместо отправки
`--debug`	Полная цепочка ошибок (то же, что `BOUNC_DEBUG`)

Таймаут HTTP задаётся переменной BOUNC_HTTP_TIMEOUT (45s, 2m; по умолчанию 30s).

Коды выхода

Код	Значение
`0`	Успех
`1`	Общая ошибка
`2`	Сеть
`3`	Аутентификация
`4`	Не найдено
`5`	Валидация

Это делает CLI пригодным для скриптов: 2 и 3 стоит повторять или чинить окружение, 4 и 5 означают, что запрос неверен по существу.

Полный список флагов

--help есть у каждой команды и подкоманды, а корневая справка дополнительно печатает глобальные флаги, коды выхода и модель аутентификации:

bounc --help
bounc issue create --help
bounc dataset record patch --help

Токены — персональные токены, токены демона и токены задач.
API — тот же контракт по HTTP.
Компьютеры и машины — что делают команды группы daemon.