Выполняет сгенерированный агентом React на странице интерфейса
Запускает агентов в выбранных рабочих папках с их собственными правами и хранит ключи профилей в локальном файле
Режимы --host, публичного адреса и --pair открывают интерфейс за пределы loopback и защищены только общим паролем или одноразовым кодом

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Macaron Artifacts запускается командой macaron-artifacts и открывает веб-интерфейс на http://127.0.0.1:43860. В нем создают беседу, выбирают агента и рабочую папку. Claude Code и pi работают через встроенные SDK, Codex и OpenCode (версий 1 и 2) через установленный и авторизованный CLI, Hermes через JSON-RPC шлюз без интерфейса, OpenClaw через клиент Gateway v4. Для запуска нужен Node.js 22.19 или новее. Центральная идея называется UI4A, то есть интерфейс для агента: агент пишет обычный React с импортами, компонентами и состоянием. Блок ui4a/tsx в тексте ответа отрисовывается по мере поступления кода и остается интерактивным. Файл .artifacts/canvases/<имя>.ui4a.tsx открывается рядом с беседой как Canvas и сохраняется между ходами. Под рукой у компонентов библиотека $ui4a/ui, KaTeX для формул, Recharts для графиков, Headless UI и любые npm-пакеты через esm.sh. Кнопка в таком компоненте может запустить следующий ход агента, а форма сохранить данные в .artifacts. Профили хранят несколько настроек на каждого агента: модель, уровень рассуждений, адрес сервиса и ключи. Запросы на подтверждение действий появляются прямо в беседе, а фоновый ход продолжается при переключении на другую беседу. Для удаленной машины есть пароль, публичный адрес за HTTPS-прокси и режим --pair для подключения размещенного интерфейса artifacts.macaron.im.

Для кого. Тем, кто работает с Claude Code, Codex или OpenCode и хочет получать от агента интерактивные графики, формы и панели вместо сплошного текста.

Подходит, если

Агент строит сводку по данным, и вместо таблицы в тексте нужен график Recharts с переключателями
Нужна форма или калькулятор, которые агент собирает прямо в беседе, без отдельного проекта
Один интерфейс нужен для нескольких агентов: Claude Code, Codex, OpenCode и pi в одном списке бесед
Агент работает на удаленном сервере, и интерфейс открывается через SSH-туннель или пароль
Формулы в ответе должны отображаться через KaTeX по мере поступления текста

Не подходит, если

Достаточно терминала: интерфейс добавляет браузер и локальный сервер, а у Codex и OpenCode нужен свой авторизованный CLI
Сгенерированному коду нельзя доверять: React выполняется на странице самого интерфейса
Нужно перенести историю старых сессий: перенос нативной истории и вложения пока не реализованы
Нужна версия 0 с плагинами для запуска из агента: прежний интерфейс и плагины лежат в архивной ветке v0

Пример запроса к агенту

Запусти Macaron Artifacts, открой беседу с Claude Code в папке этого проекта и попроси построить интерактивный график по файлу sales.csv

Ограничения

Сгенерированный React исполняется на странице интерфейса, поэтому его стоит запускать только для доверенного кода.
Без пароля локальный сервер открыт любому процессу на этой машине. Если сервер слушает не 127.0.0.1 или задан публичный адрес, пароль обязателен.
Перенос нативной истории сессий и вложения пока не поддерживаются.
Для OpenClaw обогащение метаданных требует плагина `metadata-gate` и при его отсутствии не работает.

Как отключить. Остановите процесс macaron-artifacts. Глобальную установку удаляет команда `npm uninstall -g macaron-artifacts`. Беседы приложения лежат в ~/.macaron-artifacts/sessions, рабочие файлы остаются в выбранных папках проектов и при удалении беседы не стираются.

Частые вопросы

Что такое UI4A в Macaron Artifacts?

Это способ вывода интерфейса агентом: он пишет обычный React-код, а среда отрисовывает его по мере поступления. Блок ui4a/tsx встраивается между абзацами, файл .ui4a.tsx в папке .artifacts/canvases открывается отдельной панелью.

С какими агентами работает Macaron Artifacts?

С Claude Code, Codex, OpenCode (версий 1 и 2), pi, Hermes и OpenClaw. Claude Code и pi используют встроенные SDK, Codex и OpenCode требуют установленного и авторизованного CLI.

Как открыть интерфейс на удаленном сервере?

Задайте пароль через MACARON_PASSWORD или --password, пробросьте порт командой ssh -N -L 43860:127.0.0.1:43860 user@host и откройте http://127.0.0.1:43860. Агенты, файлы и ключи остаются на удаленной машине.

Куда сохраняются ключи и токены профилей?

В закрытый локальный файл в каталоге данных приложения. В браузер они не возвращаются.

Нужен ли пароль для запуска?

Нет, локальный сервер на 127.0.0.1 работает без пароля. Пароль обязателен, если сервер слушает другой адрес или задан публичный адрес.

Обсуждение

Вопросов и отзывов пока нет.

CLI-инструменты

Agent-HTML

CLI создает холст, где ИИ-агент строит дашборды, отчеты и макеты как React-артефакты, а правки привязаны к блокам страницы

CLIРасширенный доступ347

Doop

Открытый холст для дизайна: Claude Code, Codex, ChatGPT и Cursor рисуют на нем макеты через MCP вместе с людьми

MCP-серверРасширенный доступ1,8 тыс.

Agentation

Панель разметки для React-страниц: клик по элементу дает агенту селектор и контекст, скиллы настраивают подключение и сами ведут критику интерфейса

СкиллРасширенный доступ5,3 тыс.

affectUI

Официальный

MCP-сервер библиотеки React-компонентов для интерфейсов агентов: агент находит компонент и добавляет его в проект

MCP-серверРасширенный доступ478

Talk to Figma MCP

MCP-мост между агентом (Cursor, Claude Code, Codex) и Figma: чтение макетов и правки прямо на холсте

MCP-серверРасширенный доступ7,1 тыс.

Layrr

Layrr открывает ваше веб-приложение с оверлеем: кликаете элемент, описываете правку, а агент получает точное место в исходниках

CLIШирокий доступ267

Коротко о README

Страница репозитория подает проект как открытую версию UI4A от Mind Lab и сравнивает ее с чистым HTML и схемами вроде A2UI. Далее идут установка, настройка пароля и удаленного доступа, список возможностей и таблица переменных окружения. Ссылки ведут на статью об архитектуре, песочницу genui.macaron.im и смежные пакеты.

Бейдж для README

Сообщить о проблеме