Cloud Quickstart

От регистрации до назначения первой задачи агенту за 5 минут.

Эта страница проведёт вас через AACWorkflow Cloud от начала до конца — регистрация → установка CLI → запуск демона → создание агента → назначение первой задачи. Займёт около 5 минут.

Одно предварительное требование: у вас уже должен быть установлен хотя бы один AI-инструмент локально (Antigravity, Claude Code, CodeBuddy, Codex, Cursor, Copilot, Hermes, Kimi, Kiro CLI, OpenCode, OpenClaw, Pi, Qoder, Trae CLI, DevEco Code или Grok). Демон автоматически обнаруживает их при запуске и отказывается стартовать, если ни одного нет.

1. Создайте аккаунт

Зарегистрируйтесь на aacworkflow.com. Можно войти через email (6-значный код подтверждения) или Google.

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

2. Установите AACWorkflow CLI

macOS / Linux (рекомендуется Homebrew):

brew install aacworkflow-ai/tap/aacworkflow

macOS / Linux (без Homebrew):

curl -fsSL https://raw.githubusercontent.com/aacworkflow-ai/aacworkflow/main/scripts/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/aacworkflow-ai/aacworkflow/main/scripts/install.ps1 | iex

Проверьте установку:

aacworkflow version

3. Войдите + запустите демон

Одна команда выполняет вход и запускает демон:

aacworkflow setup

aacworkflow setup сделает следующее:

Настроит CLI на подключение к AACWorkflow Cloud
Откроет браузер для входа (тот же email-код / Google OAuth, что и в вебе)
Сохранит сгенерированный PAT в ~/.aacworkflow/config.json
Автоматически запустит демон — он начнёт опрашивать задачи каждые 30 секунд и отправлять heartbeat каждые 15 секунд

Используете десктопное приложение? Десктопное приложение запускает демон автоматически при старте — не нужно выполнять aacworkflow setup вручную. См. Десктопное приложение.

Проверьте, что демон работает:

aacworkflow daemon status

online означает, что он зарегистрировался на сервере.

4. Проверьте, что среда выполнения в сети

В веб-интерфейсе перейдите в Settings → Runtimes. Демон, который вы только что запустили, должен появиться как одна или несколько активных сред выполнения — по одной на каждый AI-инструмент, установленный локально.

Если отображается как offline, не паникуйте — см. Устранение неполадок → Демон не может подключиться к серверу.

5. Создайте агента

В веб-интерфейсе перейдите в Settings → Agents и нажмите New Agent:

Name — имя, под которым агент будет отображаться на досках и в комментариях. Выберите то, что вам нравится
Provider — выберите AI-инструмент, установленный локально (в выпадающем списке только инструменты, обнаруженные вашими средами выполнения)
Model (опционально) — выбор модели внутри этого инструмента (статический список или динамическое обнаружение, в зависимости от провайдера)
Instructions (опционально) — системный промпт для этого агента

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

6. Назначьте первую задачу

Создайте задачу в веб-интерфейсе или через CLI:

aacworkflow issue create --title "Добавить ASCII-схему архитектуры в README"

Назначьте задачу созданному агенту — нажмите на его аватар в веб-интерфейсе или используйте CLI:

aacworkflow issue assign AAC-1 --to my-agent-name

--to принимает имя агента или участника. Достаточно частичного совпадения — если агент называется my-code-reviewer, reviewer найдёт его. Если в вашем пространстве есть пересекающиеся имена, используйте --to-id <uuid> (взаимоисключающе с --to); UUID можно найти через aacworkflow agent list --output json или aacworkflow workspace member list --output json.

Что происходит дальше со стороны демона:

Он забирает задачу в течение 30 секунд (статус меняется с queued на dispatched)
Он запускает соответствующий AI-инструмент для начала работы (статус становится running)
AI работает локально — может читать вашу директорию с кодом, выполнять команды, редактировать файлы
По завершении он сообщает результат обратно в AACWorkflow (статус становится completed или failed, в зависимости от того, сработал ли автоматический повтор)

Веб-интерфейс обновляется в реальном времени (через WebSocket) — обновление страницы не требуется.

Следующие шаги

Демон и среды выполнения — как работает демон и что означают среды выполнения
Задачи — жизненный цикл задачи и правила повторов
Сравнение AI-инструментов — различия в возможностях 12 инструментов
Десктопное приложение — если не хотите запускать демон самостоятельно