Text.js: фреймворк для React-приложений внутри console.log

На сайте textjs.org представлен Text.js, «консольный фреймворк» для full-stack React-приложений, которые отображаются внутри console.log. Сама страница проекта работает в консоли посетителя: нужно открыть DevTools (⌘⌥J или Ctrl+Shift+J), кликнуть по превью и управлять счётчиком стрелками вверх и вниз. В примере на странице обычный компонент React с useState и хуком useInput из пакета @textjs/app, который выводит ASCII-заголовок «▼ TEXT.JS» и значение счётчика.

По описанию на странице, Text.js поддерживает конкурентный рендеринг React 19, Suspense и границы ошибок (error boundaries). Папки в app/ становятся маршрутами и макетами в духе App Router, при этом работают кнопки «Назад» и «Вперёд» и глубокие ссылки. Сетка адаптивна и подстраивается под закреплённую панель DevTools при любом масштабе страницы. Ввод с клавиатуры, вставка и ввод через IME попадают в приложение через одно скрытое поле textarea. Заявлены таблицы, графики, формы и горячие клавиши.

Конвейер вывода описан по шагам. React фиксирует изменения через собственный reconciler (механизм согласования), Yoga раскладывает блоки по целым ячейкам, CellBuffer перерисовывает только повреждённые строки, хеш строк отсекает неизменившиеся кадры (коммит, не менявший ячейки, до консоли не доходит), RLE-кодирование сжимает кадр из 3 200 ячеек до 149 фрагментов %c, а при выводе кадры добавляются не чаще чем раз в 66 мс. Каждый изменённый кадр, один вызов console.log.

Отдельный приём, «добавляемые кадры» (Turbolog). Если очищать консоль перед каждым кадром, она остаётся пустой, пока DevTools не отрисует следующий, поэтому Turbolog добавляет кадры, а не стирает прежние. На странице приведено сравнение: «70.6% blank» для варианта clear() + log() против «1.0% blank» для log() с добавлением кадров. Метод измерения, оборудование и браузер на странице не указаны.

Маршрут можно отрисовывать на сервере, экспортировав runtime = "server": тогда на сервере рендерятся маршрут и его асинхронные компоненты, а браузер загружает не приложение, а проигрыватель кадров размером 21 кБ (gzip). Первый кадр каждого статического маршрута поставляется внутри HTML, так что консоль рисуется до загрузки JavaScript (Partial Prerendering). Есть middleware.ts с NextRequest, NextResponse и config.matcher, кеширование (revalidate, unstable_cache, revalidateTag, stale-while-revalidate) и адаптеры развёртывания для static, bun, vercel и cloudflare; серверным маршрутам нужен bun или text start.

То же приложение работает не только в DevTools (text dev). Команда text run рисует его в терминале в truecolor ANSI и исполняет обработчики маршрутов в том же процессе. Команда text mcp даёт кодинг-агентам по MCP возможность переходить по маршрутам, нажимать клавиши и читать каждый кадр как обычный текст.

В качестве демонстрации показан OpenCode Lite, интерфейс OpenCode TUI, пересобранный на Text.js для запуска в консоли браузера. Для подключения нужно выполнить bunx @textjs/opencode@latest proxy и ввести выведенный код: страница подключается к OpenCode на вашей машине, модели, сессии и агенты берутся с вашего сервера OpenCode. Есть и песочница со скриптовым агентом, который отвечает на любой запрос без установки.

Среди инструментов: расширение DevTools с панелью дерева компонентов, инспектором кадров и временной шкалой по кадрам; расширение для VS Code с предпросмотром кадра рядом с кодом; плагин ESLint (ловит DOM-теги в консольных компонентах, блоки внутри текста и глифы, которых нет в Menlo); тестирование с офлайн-рендером, нажатием клавиш и проверкой lastFrame() в любом тест-раннере; коды ошибок TX со ссылками на пояснения; REPL в консоли (window.text) для паузы, изменения размера, каркасного режима и копирования работающего приложения. Поддержка письма справа налево реализует Unicode Bidirectional Algorithm и проходит все 770 241 случай BidiTest.txt; разбор шрифтов FIGlet (.flf) совпадает с 273 записанными выводами бинарника figlet. Есть бесплатный курс «Постройте дашборд деплоев в консоли»: 10 глав, около 65 минут.

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

  • Text.js рендерит full-stack React-приложения (React 19, Suspense, App Router) в консоль браузера: каждый изменённый кадр, один вызов console.log; сама страница textjs.org работает в консоли посетителя.
  • Кадры добавляются, а не стирают консоль: на странице сравниваются «70.6% blank» для clear() + log() и «1.0% blank» для добавляемых кадров; кадр в 3 200 ячеек сжимается до 149 фрагментов %c, кадры идут не чаще раза в 66 мс.
  • Маршруты можно рендерить на сервере (runtime = "server"): браузер получает проигрыватель кадров в 21 кБ (gzip); адаптеры для static, bun, vercel и cloudflare.
  • То же приложение запускается в терминале (text run, truecolor ANSI) и открыто агентам через MCP (text mcp), которые читают кадры как текст.
  • Демо, OpenCode Lite, перенос OpenCode TUI в консоль браузера; есть расширения для DevTools и VS Code, плагин ESLint, инструменты тестирования и бесплатный курс на 10 глав.

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

Идея необычная: консоль разработчика превращается в поверхность для интерактивных интерфейсов, причём на привычном стеке React с маршрутизацией в стиле App Router, серверным рендерингом и кешированием. Ключевая инженерная находка по описанию проекта, вывод кадров добавлением вместо очистки консоли, которая иначе мигает пустым экраном. Дополнительный интерес, единая кодовая база для консоли браузера, терминала и агентов по MCP.

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

Разработчикам внутренних инструментов и панелей (дашбордов деплоя, админок), которым интерфейс удобен рядом с DevTools; тем, кто делает TUI-приложения на React; авторам инструментов для ИИ-агентов, которым нужно отдавать агенту текстовые кадры интерфейса; любителям экспериментов с консолью браузера.

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

Самый быстрый путь, открыть textjs.org с включённой консолью DevTools (⌘⌥J или Ctrl+Shift+J) и попробовать пример со счётчиком. Для OpenCode Lite нужен bun: выполнить bunx @textjs/opencode@latest proxy и ввести выведенный код; без установки доступна песочница со скриптовым агентом. Для знакомства с фреймворком на странице есть бесплатный курс (10 глав, около 65 минут). Для серверных маршрутов нужен bun или команда text start. Цена, лицензия и версия на странице не указаны.

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

Все сведения взяты с лендинга самого проекта и являются его собственными заявлениями. Автор, компания или мейнтейнер, лицензия, дата выпуска и номер версии на странице не названы. Сравнение «70.6% blank» и «1.0% blank» приведено без метода измерения, оборудования и браузера; независимых замеров, данных о пользователях и сторонних отзывов на странице нет. Работоспособность можно проверить самому, открыв страницу в консоли.

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

Проект, у которого не названы автор и лицензия, а также нет роадмапа, рискованно закладывать в долгосрочные продукты. Серверному рендерингу нужен bun или text start, а неполный список поддерживаемых браузеров на странице не приведён (упомянуты только сочетания клавиш DevTools). Консоль, нестандартная поверхность: линтер отдельно предупреждает о DOM-тегах и о глифах, которых нет в шрифте Menlo, так что отображение зависит от шрифта и размера панели. Для OpenCode Lite страница подключается к серверу OpenCode на вашей машине через proxy и введённый код, перед использованием стоит понимать, что открывается.