Справочник CLI

CLI aacworkflow подключает вашу локальную машину к AACWorkflow. Он обрабатывает аутентификацию, управление рабочими пространствами, отслеживание задач и запускает демона агентов, который выполняет AI-задачи локально.

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

Вход в браузер

aacworkflow login

Открывает браузер для OAuth-аутентификации, создаёт личный токен доступа на 90 дней и автоматически настраивает ваши рабочие пространства.

Вход через токен

aacworkflow login --token <mul_...>

Аутентификация с использованием личного токена доступа напрямую. Полезно для автоматизированных окружений. Передайте --token= с пустым значением, чтобы вводить интерактивно (токен не попадёт в историю shell).

Проверка статуса

aacworkflow auth status

Показывает текущий сервер, пользователя и срок действия токена.

Выход

aacworkflow auth logout

Удаляет сохранённый токен аутентификации.

Демон агентов

Демон — это локальный runtime'ом для агентов. Он обнаруживает доступные AI CLI на вашей машине, регистрирует их на сервере AACWorkflow и выполняет задачи, когда агентам назначается работа.

Запуск

aacworkflow daemon start

По умолчанию демон работает в фоне и логирует в ~/.aacworkflow/daemon.log.

Для запуска на переднем плане (полезно для отладки):

aacworkflow daemon start --foreground

Остановка

aacworkflow daemon stop

Статус

aacworkflow daemon status
aacworkflow daemon status --output json

Показывает PID, время работы, обнаруженные агенты и отслеживаемые рабочие пространства.

Логи

aacworkflow daemon logs              # Последние 50 строк
aacworkflow daemon logs -f           # Следить (tail -f)
aacworkflow daemon logs -n 100       # Последние 100 строк

Поддерживаемые агенты

Демон автоматически обнаруживает эти AI CLI в вашем PATH:

Нужен минимум один. Демон регистрирует каждый обнаруженный CLI как доступный runtime.

Как это работает

1. При запуске демон обнаруживает установленные AI CLI и регистрирует runtime для каждого агента в каждом отслеживаемом рабочем пространстве
2. Опрашивает сервер с настраиваемым интервалом (по умолчанию: 30 сек) на предмет назначенных задач
3. Когда приходит задача, создаёт изолированную папку работы, запускает CLI агента и отправляет результаты обратно
4. Периодически отправляет heartbeat'ы (по умолчанию: 15 сек), чтобы сервер знал, что демон живой
5. При выключении все runtime'ы дерегистрируются

Конфигурация

Поведение демона настраивается через флаги или переменные окружения:

Переопределения для каждого агента:

Профили

Профили позволяют запускать несколько демонов на одной машине — например, один для продакшена, один для staging'а.

# Настройка профиля staging
aacworkflow setup --profile staging

# Запуск его демона
aacworkflow daemon start --profile staging

# Профиль по умолчанию работает отдельно
aacworkflow daemon start

Каждый профиль получает свою папку конфигурации (~/.aacworkflow/profiles/<name>/), состояние демона, порт здоровья и корень рабочих пространств.

Рабочие пространства

Список рабочих пространств

aacworkflow workspace list

Отслеживаемые рабочие пространства отмечены звёздочкой *. Демон обрабатывает задачи только для отслеживаемых рабочих пространств.

Отслеживать / Перестать отслеживать

aacworkflow workspace watch <workspace-id>
aacworkflow workspace unwatch <workspace-id>

Получить детали

aacworkflow workspace get <workspace-id>
aacworkflow workspace get <workspace-id> --output json

Список участников

aacworkflow workspace member list <workspace-id>

Обновить рабочее пространство

Требует прав admin или owner. Все поля частично обновляются (PATCH семантика): непередаваемые поля остаются неизменными.

aacworkflow workspace update <workspace-id> --name "Acme Eng"
aacworkflow workspace update <workspace-id> \
  --description "Engineering team workspace" \
  --issue-prefix ENG

Длинный текст через stdin (сохраняет переводы строк и обратные слэши):

cat <<'CTX' | aacworkflow workspace update <workspace-id> --context-stdin
Мы 5-человечная AI-native команда.
Язык работы: русский + английский.
CTX

Редактируемые поля: --name, --description / --description-stdin, --context / --context-stdin, --issue-prefix. slug доступен только для чтения после создания, не открывается в CLI. --description и --description-stdin (и аналогично для context) взаимоисключающие. Если не передан флаг любого поля, команда отклоняется, чтобы избежать пустого PATCH. --issue-prefix "" также будет отклонён: бэкенд молча пропускает поле с пустым prefix'ом, CLI блокирует локально, чтобы избежать "похожего на успех no-op".

Задачи

Список задач

aacworkflow issue list
aacworkflow issue list --status in_progress
aacworkflow issue list --priority urgent --assignee "Agent Name"
aacworkflow issue list --assignee-id 5fb87ac7-23b5-4a7a-81fa-ed295a54545d
aacworkflow issue list --full-id
aacworkflow issue list --limit 20 --output json

Табличный вывод по умолчанию показывает issue KEY, который можно скопировать в последующие команды (например AAC-123); используйте --full-id для полного UUID. Доступные фильтры: --status, --priority, --assignee / --assignee-id, --project, --limit. В рабочем пространстве с одинаковыми именами используйте --assignee-id <uuid> для точного указания члена или агента.

Получить задачу

aacworkflow issue get AAC-123
aacworkflow issue get <uuid>
aacworkflow issue get <id> --output json

<id> принимает issue key (из таблицы aacworkflow issue list, например AAC-123) и полный UUID (используйте --full-id с list чтобы показать). Это же правило применяется ко всем командам ниже, которые принимают <id>.

Создать задачу

aacworkflow issue create --title "Fix login bug" --description "..." --priority high --assignee "Lambda"
aacworkflow issue create --title "Fix login bug" --assignee-id 5fb87ac7-23b5-4a7a-81fa-ed295a54545d

Флаги: --title (обязательный), --description, --status, --priority, --assignee / --assignee-id, --parent, --project, --due-date. Если в скрипте уже есть UUID (например из aacworkflow workspace member list --output json), используйте --assignee-id <uuid> (взаимоисключающий с --assignee) для точного указания.

Обновить задачу

aacworkflow issue update <id> --title "New title" --priority urgent

Назначить задачу

aacworkflow issue assign <id> --to "Lambda"
aacworkflow issue assign <id> --to-id 5fb87ac7-23b5-4a7a-81fa-ed295a54545d
aacworkflow issue assign <id> --unassign

--to-id <uuid> (взаимоисключающий с --to) назначает по UUID; подходит для скриптовых сценариев в рабочих пространствах с дублирующимися именами.

Изменить статус

aacworkflow issue status <id> in_progress

Допустимые статусы: backlog, todo, in_progress, in_review, done, blocked, cancelled.

Комментарии

# Список комментариев
aacworkflow issue comment list <issue-id>

# Добавить комментарий
aacworkflow issue comment add <issue-id> --content "Looks good, merging now"

# Ответить на конкретный комментарий
aacworkflow issue comment add <issue-id> --parent <comment-id> --content "Thanks!"

# Удалить комментарий
aacworkflow issue comment delete <comment-id>

История выполнения

# Список всех прогонов выполнения для задачи
aacworkflow issue runs <issue-id>
aacworkflow issue runs <issue-id> --full-id
aacworkflow issue runs <issue-id> --output json

# Посмотреть сообщения конкретного прогона выполнения
aacworkflow issue run-messages <task-id>
aacworkflow issue run-messages <short-task-id> --issue <issue-id>
aacworkflow issue run-messages <task-id> --output json

# Инкрементальная выборка (только сообщения после заданного номера последовательности)
aacworkflow issue run-messages <task-id> --since 42 --output json

Табличный вывод runs по умолчанию показывает короткий префикс UUID задачи; используйте --full-id для полного task UUID. run-messages принимает полный task UUID напрямую; копируя короткий префикс из таблицы runs, передайте вместе с ним --issue <issue-id>, CLI будет разбирать только в пределах этой задачи.

Проекты

Проекты группируют связанные задачи (например спринт, эпик, рабочий поток). Каждый проект принадлежит рабочему пространству и может опционально иметь лидера (участника или агента).

Список проектов

aacworkflow project list
aacworkflow project list --status in_progress
aacworkflow project list --output json

Доступные фильтры: --status.

Получить проект

aacworkflow project get <id>
aacworkflow project get <id> --output json

Создать проект

aacworkflow project create --title "2026 Week 16 Sprint" --icon "🏃" --lead "Lambda"

Флаги: --title (обязательный), --description, --status, --icon, --lead.

Обновить проект

aacworkflow project update <id> --title "New title" --status in_progress
aacworkflow project update <id> --lead "Lambda"

Флаги: --title, --description, --status, --icon, --lead.

Изменить статус

aacworkflow project status <id> in_progress

Допустимые статусы: planned, in_progress, paused, completed, cancelled.

Удалить проект

aacworkflow project delete <id>

Связь задач с проектами

Используйте флаг --project в issue create / issue update чтобы прикрепить задачу к проекту, или в issue list чтобы отфильтровать задачи по проекту:

aacworkflow issue create --title "Login bug" --project <project-id>
aacworkflow issue update <issue-id> --project <project-id>
aacworkflow issue list --project <project-id>

Конфигурация

Просмотр конфигурации

aacworkflow config show

Показывает путь файла конфигурации, URL сервера, URL приложения и рабочее пространство по умолчанию.

Установка значений

aacworkflow config set server_url wss://api.example.com/ws
aacworkflow config set app_url https://app.example.com
aacworkflow config set workspace_id <workspace-id>

Другие команды

aacworkflow version              # Показать версию CLI и хэш коммита
aacworkflow update               # Обновить на последнюю версию
aacworkflow agent list           # Список агентов в текущем рабочем пространстве

Форматы вывода

Большинство команд поддерживают --output с двумя форматами:

• table — удобочитаемая таблица (по умолчанию для команд list)
• json — структурированный JSON (полезно для скриптов и автоматизации)

aacworkflow issue list --output json
aacworkflow daemon status --output json