Drawgent соединяет агентов Claude Code и Codex с холстом Excalidraw

Drawgent соединяет агентов Claude Code и Codex с холстом Excalidraw

Drawgent, инструмент, который соединяет собственную установку пользователя (агент Claude Code, Codex или opencode со своим логином, конфигурацией и репозиторием) с доской Excalidraw. Пользователь либо просит диаграмму в чат-панели редактора, либо пишет пометку «AGENT: …» рядом с частью рисунка, которую нужно изменить. Агент смотрит на холст (получает скриншот и данные сцены), редактирует его вживую, проверяет результат и помечает пометку зелёной «DONE: …»; чтобы отправить запрос повторно, «DONE:» достаточно переписать обратно в «AGENT:».

Установка выполняется один раз на каждого агента командой drawgent setup : проверяются наличие CLI и логин (claude auth status, codex login status или opencode auth list), затем ставится мост ACP. Opencode говорит на ACP сам, а для Claude Code и Codex используются официальные ACP-адаптеры, их устанавливают один раз в кэш (~60 МБ) без встроенных бинарников самих агентов; для Claude- и Codex-мостов дополнительно нужен Node.js версии 18 и выше. Setup также настраивает рендерер: использует уже установленный Chrome/Chromium либо предлагает скачать Chrome Headless Shell (Chrome for Testing, ~120 МБ, без sudo) или поставить Chromium через системный пакетный менеджер. Пока настройка для агента не пройдена успешно, команда drawgent up отказывается запускаться.

Команда drawgent up, запущенная в директории проекта, поднимает редактор и API по адресу 127.0.0.1:7300 (или следующий свободный порт), открывает браузер и стартует новую сессию агента, работающую в этом рабочем пространстве; сцена холста хранится в файле .drawgent/scene.json, который автоматически добавляется в .gitignore. Флаг drawgent up --attach подключает холст к уже запущенной сессии агента вместо создания новой.

На холсте, помимо чат-панели (отправка запросов, просмотр вызовов инструментов, подтверждение разрешений, кнопка Stop для отмены хода), можно писать пометки «AGENT:», они срабатывают примерно через 2,5 секунды после остановки набора текста, вместе с координатами, тем, на что указывает пометка, и соседними элементами. Есть также «лазерные зоны»: инструментом-лазером Excalidraw (клавиша K) обводится или зачёркивается часть диаграммы, след остаётся на холсте красным контуром, а чат-панель открывается со списком элементов под зоной; отдельные штрихи, сделанные с интервалом до 4 секунд, объединяются в одну зону, следующее сообщение в чате применяется только к ней.

Drawgent умеет присоединяться к совместным комнатам excalidraw.com как участник с собственным курсором: люди могут оставаться на excalidraw.com, их пометки «AGENT:» доходят до агента, а его правки появляются у них в реальном времени; трафик к комнатам, по заявлению документации, шифруется end-to-end ключом самой комнаты.

Среди ограничений, прямо указанных в документации: рендерер пока обязательно требует Chrome (нативный рендерер только запланирован); режим «attach» к работающей сессии Claude реализован как форк процесса, поскольку у Claude Code нет публичного способа встроиться в уже запущенную терминальную сессию; живой attach для Codex реализован, но ещё не протестирован против залогиненного Codex; на одно рабочее пространство поддерживается только одна сцена, а изображения и файлы не синхронизируются. Отдельно подчёркивается, что агенты никогда не поставляются в комплекте с drawgent, они всегда запускаются через собственную установку пользователя. Автор, поддерживающий проект, дата релиза, версия и условия лицензирования в источнике не указаны.

Ключевые факты

  • Drawgent подключает уже установленного и залогиненного агента (Claude Code, Codex или opencode) к живой доске Excalidraw через ACP-мост
  • Работа идёт через чат-панель или пометки «AGENT:» на холсте (срабатывают через ~2,5 с после остановки набора); агент помечает готовое зелёной пометкой «DONE:»
  • Поддерживаются совместные комнаты excalidraw.com с шифрованием трафика ключом комнаты и «лазерные зоны», обведённые лазером Excalidraw участки для точечных правок
  • Установка ACP-адаптеров для Claude Code/Codex занимает около 60 МБ, опциональный headless Chrome для рендера, около 120 МБ; редактор по умолчанию слушает 127.0.0.1:7300
  • Ограничения: рендерер пока обязательно требует Chrome, attach-режим Claude реализован через форк процесса, на рабочее пространство доступна только одна сцена, изображения и файлы не синхронизируются

Почему это важно

Drawgent не создаёт нового ИИ-агента, а даёт уже существующим кодовым агентам, Claude Code, Codex, opencode, визуальный интерфейс поверх графического холста вместо привычного текстового терминала. Это расширяет их применение на задачи вроде схем архитектуры, диаграмм баз данных и совместного визуального планирования, где раньше агент мог работать только с текстом и кодом.

Кому это важно

Инструмент нацелен на разработчиков и инженеров, которые уже пользуются Claude Code, Codex или opencode и хотят обсуждать и правя диаграммы вместе с агентом в реальном времени, а также на команды, где часть участников работает в общей комнате excalidraw.com и получает правки агента прямо на своём холсте.

Как это применить

Нужен установленный и залогиненный claude, codex или opencode (для Claude- и Codex-мостов, дополнительно Node.js 18+). Один раз для каждого агента выполняется drawgent setup : проверка CLI и логина, установка ACP-адаптера (~60 МБ) и настройка рендерера на headless Chrome (~120 МБ) или системный Chromium. Затем в директории проекта командой drawgent up поднимается редактор на 127.0.0.1:7300 и стартует сессия агента; drawgent up --attach подключает холст к уже запущенной сессии. Есть также низкоуровневая команда drawgent serve для скриптов и контейнеров и Docker-образ canvas-сервера без встроенных агентов.

Можно ли доверять

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

Риски и подводные камни

Сама документация признаёт ряд ограничений: рендерер пока обязательно требует Chrome (нативный рендерер только запланирован), attach-режим для работающей сессии Claude реализован как форк процесса из-за отсутствия публичного способа встроиться в терминал, а живой attach для Codex ещё не протестирован против залогиненного Codex. Кроме того, на рабочее пространство поддерживается только одна сцена, изображения и файлы не синхронизируются, а агенты никогда не поставляются в комплекте, для работы всегда нужна собственная установка и логин пользователя.

«Агенты никогда не поставляются в комплекте, они всегда работают через вашу собственную настройку.»

— документация drawgent