Интенсив 21–22.11 · БесплатноБесплатный 2-дневный интенсив по вайбкодингу 21–22 ноября в 16:00 МСК (Сб–Вс) · Живой Поток 3 стартует 23.11Записаться бесплатно →Поток 3 (23.11)
РелизКод / SDK · В работуHabr AI→ оригинал

Мод для Claude Code, рисующий карту работы агента, набрал 1000 звёзд за 10 дней

Автор попросил агента на Claude Code нарисовать свою работу и оформил картинку как мод: в центре модель, вокруг десять станций — файлы, терминал, сеть, память. За десять дней репозиторий набрал 1000 звёзд, а 11 ноября, по просьбам пользователей, вышло 14 версий за сутки. Мод только наблюдает и ничего не меняет, поэтому автор отказал в кнопках запрета и скинах. Вывод для авторов расширений: узкий фокус и записанные принципы дают больше доверия, чем куча функций.

AI-обработка оригинала Habr AI; редакция Hamidun News
Мод для Claude Code, рисующий карту работы агента, набрал 1000 звёзд за 10 дней
Источник: Habr AI. Коллаж: Hamidun News.
Слушать статью
Паспорт материала и цифры
ПараметрДанные
ПервоисточникHabr AI ↗
Главный редактор
Ключевой факт #1iTerm2 за пять минут раздувался с 286 МБ до 17 ГБ — картинку отключили
Ключевой факт #2От curl с токеном на карте остаётся только слово curl, от адреса — хост
В Японии проверка на 40 вызовахвсе попали на верную станцию

Когда агент работает в терминале, видно только поток строк. Что он сейчас делает: читает файлы, ходит в сеть, запускает субагента? Понять это можно, но приходится вглядываться в лог. Автор мода lot-map решил эту проблему простым способом. Он попросил свой агент на Claude Code нарисовать, как тот сам видит свой рабочий процесс, и из рисунка сделал расширение. За десять дней у репозитория набралось 1000 звёзд. Для маленького open-source-проекта это хороший результат, а ещё лучше то, как его вели.

Как это работает и как росло

На карте в центре стоит модель, вокруг неё десять станций: файлы, терминал, сеть, память, субагенты, хуки и другие. Когда агент вызывает инструмент, к нужной станции бежит импульс, а под картой видны последние вызовы. Первая версия вышла 9 ноября, и автор показал её в r/ClaudeAI с видеороликом. В ночь на 11 ноября было 100 звёзд, 12 ноября — 500, 18 ноября — 1000.

Рост шёл вместе с обратной связью. Только 11 ноября вышло четырнадцать версий: почти каждая просьба из комментариев превращалась в релиз. Так появились разворот карты, свои цвета, прозрачный фон, исправление путей Windows и подписи на итальянском и португальском. Сейчас версия 0.12.0. Больше всего хвалят кольцо вокруг центра, которое показывает, насколько заполнен контекст. Есть и счётчик токенов: он показывает, сколько каждый вызов добавил в контекст.

Терминал, iTerm2 и каталог Anthropic

Картинки в Claude Code рисуются только в приложении и VS Code, а в терминале остаются строки. Автор попробовал нарисовать карту символами и признал, что получилось плохо: семь строк без движения. Тогда подключились энтузиасты. Один прислал 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. Урок простой: не подгоняйте продукт под площадку, пока не выяснили её условия.

Что отвергли и почему мод получил доверие

Автор отказался от скинов со стимпанком и кометами: карта нужна, чтобы с одного взгляда понять, чем занят агент, а комета уже украшение. Отказался от кнопок, которыми можно было бы запретить агенту сеть или терминал: мод только смотрит и ничего не меняет, и на этом держится доверие. Отказался и от слоя для других агентов, потому что никто не запускал карту ни в чём, кроме Claude Code. Порты живут в отдельных репозиториях.

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

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

Проверки со стороны

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

Для тех, кто пишет расширения к агентам, вывод практический. Узкая роль «только смотрю» позволила сформулировать проверяемые гарантии. Список принципов с тестами помог отказывать в чужих идеях без споров. Ограничения тоже честные: это обзор, а не замена логу, и в терминалах без поддержки картинок карта выглядит беднее. Посмотреть мод можно в браузере на alexeyw.github.io/lot-map, код лежит в репозитории alexeyw/lot-map.

Сюжет

Вопросы и ответы по материалу

Что известно по теме: как это работает и как росло?

На карте в центре стоит модель, вокруг неё десять станций: файлы, терминал, сеть, память, субагенты, хуки и другие. Когда агент вызывает инструмент, к нужной станции бежит импульс, а под картой видны последние вызовы. Первая версия вышла 9 ноября, и автор показал её в r/ClaudeAI с видеороликом. В ночь на 11 ноября было 100 звёзд, 12 ноября — 500, 18 ноября — 1000. Рост шёл вместе с обратной связью. Только 11 ноября вышло четырнадцать версий: почти каждая просьба из комментариев превращалась в релиз.

Что известно по теме: терминал, iTerm2 и каталог Anthropic?

Картинки в Claude Code рисуются только в приложении и VS Code, а в терминале остаются строки. Автор попробовал нарисовать карту символами и признал, что получилось плохо: семь строк без движения. Тогда подключились энтузиасты. Один прислал pull request на 2000 строк, где мод сам рисует PNG и отдаёт его терминалу кадр за кадром (версия 0.6.0). Другой сделал карту шрифтом Брайля для терминалов без поддержки картинок, например Windows Terminal. Потом нашёлся неприятный сбой.

Что известно по теме: что отвергли и почему мод получил доверие?

Автор отказался от скинов со стимпанком и кометами: карта нужна, чтобы с одного взгляда понять, чем занят агент, а комета уже украшение. Отказался от кнопок, которыми можно было бы запретить агенту сеть или терминал: мод только смотрит и ничего не меняет, и на этом держится доверие. Отказался и от слоя для других агентов, потому что никто не запускал карту ни в чём, кроме Claude Code. Порты живут в отдельных репозиториях.

ЖХ
Жемал Хамидун — CPO Alpina Digital, продакт-менеджер AlpinaGPT. Делает AI-продукты с 2019 года. Hamidun News — pet project, который вырос в production-агрегатор с 6000+ читателей.
✦ Практика · Hamidun Academy

Соберите рабочего ИИ-агента или сервис своими руками без ручного кода

В Академии Жемала Хамидуна (academy.hamidun.com) открыт бесплатный 72-часовой тест-драйв: интерактивные скетч-уроки по Claude Code и Cursor, живой Tech Radar и готовые шаблоны агентов.

Открыть 72ч бесплатный доступ →Интенсив по Вайб-кодингу
Что вы думаете?
Загружаем комментарии…