Ставьте задачи — бот их сделает
В Labra исполнителем задачи может быть ИИ‑бот. Напишите ему комментарий с телефона — он возьмётся, поработает в вашем репозитории и вернётся с ответом, веткой и MR. Подключение — пять шагов и ни одной команды в терминале.
Пять шагов до первого бота
Бота создают в приложении на компьютере — там он сразу и начинает работать; телефон и веб остаются пультом. Консоль нужна только тем, кто ставит бота на свой сервер.
Поставьте Labra на компьютер
Боты работают на компьютере: там у них ИИ‑движки, рабочие папки и доступ к репозиториям. Телефон остаётся пультом — ставить задачи и читать ответы можно откуда угодно.
На Mac — DMG с главной страницы, на Windows — установщик оттуда же. Внутри приложения уже есть всё для работы ботов. Linux или свой сервер? См. блок «Свой сервер или Linux» ниже.
Создайте бота — он сразу появится на этом компьютере
В приложении на компьютере откройте Настройки → Боты и нажмите «Настроить бота». Мастер проведёт по всем шагам сам: придумайте имя, выберите ИИ‑движок — Claude Code, OpenCode или Codex CLI — и покажите рабочую папку. Отдельной установки нет: по завершении мастер сам настроит и запустит бота.
Движок должен быть установлен на этом же компьютере — со своей подпиской. Прогон задачи считается на вашей машине, ваш код никуда не пересылают. Нет подписки или у компании свой шлюз? Подключите провайдера моделей — раздел ниже.
Бот работает фоном: приложение закрыли — задачи всё равно берутся, после перезагрузки компьютера всё поднимается само. В трекере у бота горит «онлайн». Крышку ноута можно закрыть — кофе‑режим не даст компьютеру уснуть, а вы всё видите и правите с телефона.
Покажите рабочую папку
Рабочая папка — где боту работать. Это может быть один git‑репозиторий или папка сразу с несколькими проектами и обычными рабочими файлами — какой репозиторий нужен задаче, бот определит сам по её тексту.
Для каждой задачи бот готовит отдельную копию кода и свою ветку. Ваши незакоммиченные правки он не тронет — и наоборот.
Пригласите бота в проект и назначьте на задачу
У каждого бота есть свой email — из карточки бота в настройках. Добавьте его в проект как обычного участника; коллеги приглашаются так же — прямо из формы проекта.
Дальше всё как с людьми: создайте задачу — или возьмите существующую — и назначьте бота исполнителем. Люди и боты работают в одном проекте и видят одну доску.
Напишите комментарий — дальше он сам
Напишите в треде задачи, что нужно сделать, — с телефона, из метро, поздно вечером. Бот сразу возьмётся: ответит в треде, заведёт ветку с изменениями и MR, обновит статус и карточку задачи. Доска живая: «в работе», план и «решена» появляются на экране в ту же секунду.
Дальше это обычная переписка. Уточняйте, просите правки, задавайте вопросы — бот продолжает работу с того места, где остановился, даже на следующий день. Задача готова — закрывайте её одним движением.
Свои модели и корпоративный шлюз
Движку нужна модель — обычно он берёт её по вашей подписке. Но можно подключить провайдера моделей: шлюз компании, агрегатор (OpenRouter), локальные модели (Ollama, LM Studio) или облака — Groq, DeepSeek, Z.AI/GLM, Kimi и другие. Ключи хранятся только на вашем компьютере — на сервер Labra они не уходят.
Откройте Настройки → Боты → «Провайдеры» и нажмите «Добавить провайдера». Выберите шаблон — OpenRouter, Ollama, Groq, DeepSeek, Z.AI, Kimi, «Корпоративный шлюз» и другие: адрес подставится сам.
Вставьте API‑ключ (корпоративному шлюзу его выдаёт администратор, локальным Ollama и LM Studio ключ не нужен) и нажмите «Проверить»: приложение спросит у провайдера список моделей — «Моделей: N — ключ работает».
Создайте бота (или откройте его настройки) и в блоке «Провайдер» выберите провайдера и модель из списка. Правило простое: openai‑совместимые шлюзы и агрегаторы — для движков OpenCode и Codex CLI, протокол Anthropic — для Claude Code. Неподходящую пару приложение просто не даст сохранить; бот без провайдера работает как раньше.
Привяжите бота к работе как обычно: пригласите его email в проект, назначьте исполнителем задачи — и напишите комментарий. Один провайдер можно раздать нескольким ботам, а смена ключа — правка в одном месте: боты подхватят новый при перезапуске.
Если шлюз корпоративный:
он доступен только из сети компании (включите VPN), список рабочих моделей спросите
у администратора, а при TLS‑ошибках в корпоративной сети поможет корневой сертификат
компании — переменная NODE_EXTRA_CA_CERTS (на Windows встречается
CRYPT_E_NO_REVOCATION_CHECK). Подробнее — в инструкции
«Свои модели для ботов» в репозитории проекта (doc/bot-providers-guide.md).
Свой сервер или Linux
Без приложения — консольной утилитой labra-agent.
Бот в трекере тот же: создайте его в приложении на компьютере, а на сервере
запустите четырьмя шагами.
Создайте бота в приложении — Настройки → Боты — и скопируйте его токен (показывается один раз, при создании).
Соберите утилиту (нужен Dart SDK):
cd agent && dart compile exe bin/watch.dart -o labra-agent
Положите рядом конфиг config.json:
{
"server": "https://tracker.labrahub.ru",
"token": "<токен бота>",
"runner": "claude",
"runnerPath": "/usr/local/bin/claude",
"workdir": "/srv/work"
}
server — адрес вашего трекера, token — токен бота,
runner — ИИ‑движок (claude, opencode или codex),
runnerPath — полный путь к нему, workdir — рабочая папка с репозиториями.
В файле лежит токен — ставьте права «только владельцу» (chmod 600).
Свои модели на сервере: поля "provider" и "model" в этом же
конфиге, сам провайдер описывается в providers.json рядом с папками ботов
— формат в agent/README.md репозитория.
Запустите фоновый режим с автозапуском:
./labra-agent autostart
Бот переживёт перезагрузку сервера; лог каждого бота — agent.log
в его папке. Всё, дальше — шаги 3–5 из таблицы выше.
Что умеет бот
Не «чат с моделью», а член команды со своей машиной, памятью и задачами.
Работает, пока вас нет
Прогон идёт на вашем компьютере: бот трудится ночью, в выходные и пока вы на созвоне. Ноутбук можно закрыть — кофе‑режим не даст ему уснуть. Написали с телефона — к возвращению за стол всё готово.
Помнит контекст
Не нужно пересказывать задачу заново: бот продолжает с того же места — и через пять минут, и через пять дней. Ведёт план работ в карточке задачи.
Не мешает вашим рукам
Каждая задача — отдельная копия кода и своя ветка. Ваши текущие правки не задеты, готовое приезжает веткой и MR.
Сам ведёт порядок
Статусы, карточки, план по задаче — бот обновляет сам, а доска живая: взял задачу, отчитался, решил — все видят это в ту же секунду.
Ботов — сколько нужно
Заведите несколько: у каждого своё имя, своя рабочая папка и свои задачи. Один на фронтенд, другой на бэкенд, третий — на отчёты.
Слышит только вас
Указания боту отдаёт только его владелец. Чужие комментарии в задачах он не видит — посторонний не сможет направить вашего бота.
Частые вопросы
Что нужно, чтобы бот заработал?
Приложение Labra и один из ИИ‑помощников на компьютере — Claude Code, OpenCode или Codex CLI, с вашей подпиской. Всё счисление происходит на вашей машине: ваш код, ваш движок, ваша подписка. Трекер только приносит задачи и уносит ответы.
Это безопасно?
Токен бота не покидает ваш компьютер. В трекер попадает только то, что вы и так видите в задаче: комментарии, статусы, карточки. Указания передаются только от владельца бота, а сторонние ИИ‑движки получают лишь то, что нужно конкретной задаче.
Приложение закрыто — бот всё равно работает?
Да. На Mac, Windows и Linux бот живёт в фоне и переживает перезагрузку компьютера. Онлайн‑статус в трекере показывает, что он на связи и готов брать задачи.
А можно поработать с ботом в терминале?
Можно: в карточке бота есть готовая команда «Консольная сессия» — скопируйте и вставьте в терминал, инструменты трекера подключатся сами. Это тот же бот: контекст, задачи и права у него общие, так что консоль удобна, чтобы разобрать сложный шаг вместе с ним вживую.
У команды свои модели — корпоративный шлюз, OpenRouter, Ollama. Бот сможет?
Сможет: в Настройки → Боты → «Провайдеры» заводится любой openai‑совместимый шлюз или агрегатор (а для Claude Code — релеи с протоколом Anthropic). Ключ вставляется один раз и проверяется кнопкой «Проверить», дальше провайдер и модель выбираются в настройках бота. Ключи хранятся только на машине бота. Подробности — в разделе «Свои модели и корпоративный шлюз» выше.
А если задача не кодовая?
Рабочая папка — не только репозитории: заметки, документы, скрипты — что угодно. Бот разберётся: для кодовых задач сделает ветку и MR, для всего остального поработает с файлами прямо в папке и отчитается в треде.