Облачный агент через GitHub

Штаб это главная папка с правилами и задачами для агента. Отделы это папки рядом с ним, по одной на повторяемый процесс. Подключение GitHub есть почти во всех облачных сервисах: ChatGPT, Claude, Manus, Perplexity.

Где работает агент и где лежат файлы

Агент работает в облаке сервиса, как чат на сайте, только с доступом к вашим папкам в GitHub. Файлы лежат в репозитории, так называется папка проекта на GitHub. В репозитории копия штаба и отделов, а рядом слой задач, issues. На ноутбуке те же папки синхронизируются с GitHub, поэтому правка из облака и правка за ноутбуком попадают в одно место.

Зачем нужен GitHub, видно по двум вопросам: где живёт задача и кто может её продолжить. Задача в файле видна только агентам на этом компьютере. Когда компьютер выключен, облачный агент её не видит. Задача в GitHub живёт по ссылке, и её продолжает любой агент: облачный, на сервере, у коллеги.

Что настроить один раз

1. Заведите аккаунт GitHub. Он бесплатный, нужна почта.
2. Установите git и войдите в GitHub с компьютера. Git ведёт историю правок в папке. Установку и вход агент делает сам: дайте ему ссылку на статью "GitHub Projects как память для AI-агента": sereja.tech/blog/github-projects-ai-agent-memory.
3. Опубликуйте штаб в приватном репозитории. Промпт для агента ниже. Когда агент закончит, проверьте, что репозиторий приватный: публичный репозиторий видит весь интернет, боты сканируют его, и ключи утекают за минуту.
4. Подключите GitHub в облачном сервисе, например в ChatGPT.

Опубликуй в ПРИВАТНОМ репозитории на GitHub эту папку. Используй GH CLI, если доступен, если нет, установи доступным образом. Настрой авторизацию через HTTP

Источник: урок 6 программы Personal Corp.

GH CLI это программа GitHub для терминала. Авторизация через HTTP означает вход через браузер: агент попросит открыть страницу и ввести код.

Проверка: в ChatGPT с подключённым GitHub спросите "Что у меня на сегодня?". Агент сходит в GitHub и покажет задачи из issues.

Как работать каждый день

• Спросить о делах. Агент читает issues штаба и отвечает, какие задачи открыты и что из них на сегодня.
• Продолжить задачу по ссылке. Вставьте ссылку на issue в чат ChatGPT с подключённым GitHub. Агент читает задачу и продолжает работу. С телефона так можно работать откуда угодно.
• Отправить правку из облака. Агенты много дней вели работу, Codex проверил результат и нашёл замечание, которое затрагивает 118 файлов. Со смартфона ушло одно сообщение: "Исправь замечание в ревью". Агент подключился через GitHub и починил из облака, без компьютера. Позже можно вернуться и проверить, исправилось ли замечание.
• Проверять результат. Коммит это сохранённая правка. В каждом коммите агент ссылается на задачу и пишет отчёт: что сделано и какие файлы изменены. Codex сверяет сделанное с задачей. Если всё сходится, правку смотрите вы и вливаете в основную версию.
• Смотреть доску с телефона. GitHub Projects собирает задачи из нескольких репозиториев на одну доску.

Ограничения

• Агент видит только репозиторий. Папки и программы, которые остались на компьютере вне GitHub, облачному агенту недоступны.
• Лимит запросов. Бесплатный GitHub даёт 5 тысяч запросов в час. Много проектов и агенты, которые работают постоянно, съедают лимит, и с задачами ничего сделать нельзя. Начинать с GitHub всё равно стоит.
• Сбои GitHub. GitHub иногда недоступен час или два.
• Репозиторий только приватный. Публичным его не делают. Человека можно пригласить с правами только на чтение.

Задачи можно вести и в другом сервисе: Яндекс.Трекер, Linear, Trello. Нужно одно: у каждой задачи своя ссылка, и агент пишет отчёт прямо в задачу.

Через GitHub агент может работать и сам, без вашего запроса: GitHub Actions запускает его по событию или по расписанию. Как это собрать, разбирает глава «Агент вне ноутбука: запуск по событию и расписанию».

Когда нужна своя машина, где агент круглые сутки работает с полной копией проекта, подходит агент на сервере, о нём следующая глава.