Пару недель назад мне попалась красочная визуализация работы чьего‑то харнесса. Повосхищался пару минут и решил, что хочу себе что‑то такое же, но для своего случая и попроще.

Сразу же обратился к своему агенту на базе Claude Code с просьбой нарисовать, как он сам представляет свой рабочий процесс. Он нарисовал карту: в центре модель, вокруг десять станций — файлы, терминал, сеть, память, субагенты, хуки и так далее. Вызвал инструмент — к станции бежит импульс. Под картой список последних вызовов.

Мне понравилось. Решил поделиться.

И тут понеслось.

Десять дней в цифрах

Первая версия вышла 9 ноября. Я написал пост в r/ClaudeAI с видео.

  • в ночь на 11 ноября — 100 звёзд

  • 12 ноября — 500

  • 18 ноября — 1000, на десятый день

11 ноября вышло четырнадцать версий за сутки. Люди писали в комментариях, чего им не хватает, и почти каждая просьба становилась версией. Попросили развернуть карту, чтобы «вы» были снизу, — сделали. Попросили свои цвета — сделали. Прозрачный фон — сделали. Кто‑то прислал исправление для путей Windows, кто‑то итальянские подписи, потом португальские.

Сейчас версия 0.12.0.

Что прикрутили

Коротко, без порядка:

  • кольцо вокруг центра, которое показывает, насколько заполнен контекст. Его в отзывах хвалят чаще всего остального

  • маршрут: тонкая линия между последними станциями

  • фоновые задачи остаются на карте, пока не закончатся

  • семь языков подписей, из них итальянский и португальский прислали

  • кнопки масштаба в VS Code, тоже чужие

  • сколько токенов каждый вызов добавил в контекст

Что попробовали, передумали и передумали обратно

Главная история тут — карта в терминале.

Картинку Claude Code даёт рисовать моду только в приложении и в VS Code. В терминале были одни строки. На второй день после выхода пришёл первый вопрос: а где графика?

Я попробовал сам. Карта из символов, десять станций по кругу:

                      ○ You 2
           Hooks 2 ✕           ○ Model 14
     Skills 1 ○                     ○ Memory 5
               ( CLAUDE · opus 5.5 )
       Agents ·                     ○ Files 9
           Browser ·           ● Shell 6
                    ○ Network 3

Получилась гадость. Семь строк экрана, никакого движения, а без движения на карту незачем смотреть. В мод это не пошло, осталось на время отдельной веткой для желающих странного.

А потом пошли энтузиасты со своими версиями.

Один прислал pull request на 2000 строк: мод сам рисует карту в PNG и отдаёт терминалу, кадр за кадром. Работает в терминалах, которые умеют показывать картинки. Попросил доработать, и в итоге приняли, вышло в 0.6.0.

Другой сделал карту шрифтом Брайля, для терминалов без картинок вроде Windows Terminal. Тоже приняли.

Дальше картинка успела сломаться и починиться.

Через несколько дней после её выхода человек написал, что у него кончилась память. Проверили: iTerm2 за пять минут вырос с 286 МБ до 17 ГБ. Терминал хранил каждый кадр до закрытия вкладки. Обойти это со стороны мода не получилось, и в 0.9.0 картинку в iTerm2 выключили.

Я отправил отчёт автору iTerm2. Он исправил это на следующий день. В 0.12.0 картинку вернули, начиная с iTerm2 3.7.8.

Вторая история короче. Решил закинуть мод в каталог Anthropic. Чтобы пройти автоматическую валидацию, пришлось кое‑что подрезать и добавить. Каталог не принимал моды с хуком на проверку разрешений. В 0.4.0 хук убрали, вместе с ним пропали две строки на карте. В итоге после всех проверок и отправки заявки пришёл отказ, выяснилось: что этот каталог берёт моды только от проверенных организаций и нас не возьмёт в любом случае. В 0.5.0 хук вернули.

Ещё туда‑сюда съездил MP4 с демо: убрали из репозитория, а на него снаружи вели ссылки. Вернули.

От чего отказались

Скины. Предлагали целые оформления, стимпанк и ночное небо с кометами. Выглядело красиво. Не взяли: карта нужна, чтобы с одного взгляда понять, чем занят агент, а с кометами это уже украшение. Цвета при этом настраиваются, так что стимпанк собирается и без кода.

Кнопки на станциях. Просили, чтобы с карты можно было запретить агенту сеть или терминал. Отказались сразу. Мод только смотрит и ничего не меняет, и на этом держится всё доверие к нему.

Слой для других агентов. Прислали pull request с адаптером под другие хосты. Не взяли: никто не запускал карту ни в чём, кроме Claude Code, а тащить код под то, чего нет, не хочется. Порт лучше живёт отдельным репозиторием, и такие уже появились.

Выбор

Просьбы тянули в две стороны. Можно было разрастаться в универсальный мод со всем подряд: рубильники, скины, другие агенты. Или остаться маленьким визуальным дополнением.

Остались маленьким. На пятый день сформулировали основные принципы, их шесть:

  1. Мод смотрит и ничего не меняет

  2. В подписи только имя, никакого содержимого

  3. Он почти ничего не стоит

  4. Сбой на карте не доходит до работы

  5. Карта спокойная

  6. Работает без настроек, а что у вас настроено, остаётся

Под каждым принципом написано, какой тест его защищает. Для первого есть тест, что событие уходит дальше ровно таким, каким пришло. Для третьего — замеры с бюджетом по времени. Плюс в репозитории лежит список всего, о чём мод вообще просит Claude Code, и проверка на каждом pull request сверяет с ним код. Сети, чтения файлов и запуска процессов в этом списке нет.

Рядом пять вопросов, которыми взвешивается любая новая идея. Первый из них: надо ли для этого менять событие или отказывать в нём? Если да, это не для этого мода.

Второй принцип понадобился раньше, чем был записан. Мод получает каждый вызов агента целиком: командную строку, пути, адреса с параметрами. А панель на экране, экран попадает на скриншоты. Поэтому от команды curl с токеном в заголовке на карте остаётся слово curl, от адреса — только хост. На третий день читатель кода нашёл способ записать адрес так, что пароль из него всё‑таки попадал в подпись. Исправили в тот же день.

Обзоры

С момента публикации вышло несколько обзоров в разных профильных блогах.

В Японии сняли видео с проверкой: пять задач, сорок вызовов, сверка с картой каждые полсекунды. Все сорок попали на правильную станцию. Имя цели показалось в тридцати из сорока, и вывод там честный: карта даёт обзор, но лог не заменяет.

В Китае на CSDN вышло минимум шесть статей, одна из них целиком про то, как устроена анимация в SVG. У репозитория там появилось зеркало.

В Испании мод прогнали через сканер безопасности и вручную разобрали десять его срабатываний. Все десять оказались ложными: сканер ругался на слова вроде curl и sudo в тестах и комментариях.

Что сделали из него другие

Двое взяли код дальше. Один сделал оверлей для Codex на тех же файлах рисования. Второй собрал свою панель и добавил то, чего у меня нет: ленту, куда ушло время хода. Оба указали источник.

Вывод

Мод простейший, ничего не делает, просто показывает текущую активность. Видимо, мой агент оказался гением, раз такая штука вообще залетела и понравилась людям.

Посмотреть без установки: https://alexeyw.github.io/lot‑map/ — там в браузере крутится выдуманная сессия на настоящем коде мода.

Репозиторий: https://github.com/alexeyw/lot‑map